Upwork Agent Plugin

Portable agent workflows for hiring and finding work on Upwork. Learn more on the Upwork MCP site.

This repository follows the Agent Plugins specification v1.0.0. Compatible clients discover the remote MCP server from mcp.json and Agent Skills from immediate subdirectories of skills/.

Included components

• mcp.json connects to Upwork over the Streamable HTTP transport.
• skills/write-job-post guides clients from a rough need to a reviewed job post, then through publishing, updating, and closing it.
• skills/hire-on-upwork guides clients from candidates to a contract through freelancer search, proposal review, invitations, and offers.
• skills/write-proposal creates tailored, evidence-based proposals and guides freelancers through Connects, attachments, boosting, and submission review.
• skills/upwork-workflows defines the cross-cutting conventions: account selection, tool discovery, role routing, identifier handling, draft-confirm chains, pagination, and error handling.

Install

npx skills — recommended for any Agent Skills host

Install the skills in this repository with the open-source Skills CLI. It supports Claude Code, Cursor, Codex, and many other Agent Skills hosts:

npx skills add https://github.com/upwork/upwork-agent-plugin

The installer finds all four skills and prompts for which ones to install, which agents to configure, and whether to use project or global scope.

Claude Code

/plugin marketplace add upwork/upwork-agent-plugin

/plugin install upwork-agent-plugin@upwork

The plugin installation includes the skills and the Upwork MCP server declaration. Complete the browser-based authorization flow when prompted.

Codex

codex plugin marketplace add upwork/upwork-agent-plugin

codex plugin add upwork-agent-plugin@upwork

Alternatively, run codex, open /plugins, select Upwork, and install upwork-agent-plugin interactively.

Antigravity

# Antigravity CLI (global):
agy plugin install https://github.com/upwork/upwork-agent-plugin

# Antigravity 2.0 / IDE (global) - if you don't have Antigravity CLI installed:
git clone https://github.com/upwork/upwork-agent-plugin \
  ~/.gemini/config/plugins/upwork-agent-plugin

# OR workspace-level (either version) — clone into your project instead:
git clone https://github.com/upwork/upwork-agent-plugin \
  /.agents/plugins/upwork-agent-plugin

Other Agent Plugin-compatible clients

Add this repository URL in the client’s plugin installer:

https://github.com/upwork/upwork-agent-plugin

Compatible clients discover plugin.json, mcp.json, and every skill under skills/.

The root files are the portable Agent Plugins package. The .claude-plugin and .agents directories provide client-specific marketplace compatibility.