{"article":{"id":55446516654611,"url":"https://upwork.zendesk.com/api/v2/help_center/en-us/articles/55446516654611.json","html_url":"https://support.upwork.com/hc/en-us/articles/55446516654611-How-to-use-Upwork-with-AI-agents-through-MCP","author_id":42335513083539,"comments_disabled":false,"draft":false,"promoted":false,"position":0,"vote_sum":-2,"vote_count":2,"section_id":360003425253,"created_at":"2026-09-15T18:54:06Z","updated_at":"2026-10-02T19:32:48Z","name":"How to use Upwork with AI agents through MCP","title":"How to use Upwork with AI agents through MCP","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-10-02T19:32:48Z","user_segment_id":null,"permission_group_id":286268,"content_tag_ids":["01M2K866WXN5GRD618C012N00B"],"label_names":["filter-cl","filter-fl","filter-ag","MCP","Upwork MCP"],"body":"<p>Upwork’s Model Context Protocol (MCP) server lets you securely connect supported AI agents to your Upwork account.</p><h2 id=\"h_01M2K782PHBPYZ7QVFBDDXTDF2\">Set up and use Upwork MCP</h2><p><span style=\"color: #181818;\">Visit </span><a href=\"https://www.upwork.com/ai/mcp\" target=\"_blank\" rel=\"noopener noreferrer\"><span class=\"wysiwyg-underline\">Connect your AI agent to Upwork with MCP</span></a><span style=\"color: #181818;\"> for setup instructions, supported AI agents, available capabilities, permissions and confirmations, security information, and basic troubleshooting.</span></p><h2 id=\"h_01M2K782PN98HW0ZJMJG2H4XXX\">Follow Upwork’s rules when using MCP</h2><p><span style=\"color: #181818;\">Your use of Upwork MCP must follow the </span><a href=\"https://www.upwork.com/legal#apimcpterms\" target=\"_blank\" rel=\"noopener noreferrer\"><span class=\"wysiwyg-underline\">Upwork API and MCP Terms of Use</span></a><span style=\"color: #181818;\">, along with Upwork’s other applicable terms and policies.</span></p><div class=\"callout callout-transparent\">\n<h4 id=\"h_01M3Z1MPYPJR99TZ0B60SF6NKH\">Building a custom workflow?</h4>\n<p>Make sure it follows Upwork API and MCP <a href=\"https://www.upwork.com/legal#apimcpterms\" target=\"_blank\" rel=\"noopener noreferrer\">Terms of Use</a>.</p>\n</div><h2 id=\"h_01M2K782PNJ0CG71HMHHTJC2QC\">Get help with Upwork MCP</h2><p><span style=\"color: #181818;\">Start with the setup and troubleshooting guidance on </span><a href=\"https://www.upwork.com/ai/mcp\" target=\"_blank\" rel=\"noopener noreferrer\"><span class=\"wysiwyg-underline\">the Upwork MCP page</span></a><span style=\"color: #181818;\">.</span></p><p><span style=\"color: #181818;\">If you still need help, </span><a href=\"https://support.upwork.com/hc/en-us\"><span class=\"wysiwyg-underline\">contact Upwork Support</span></a><span style=\"color: #181818;\">. To help us understand the issue, include:</span></p><ul>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #181818;\" data-list-item-id=\"ee4d17bae168477866505b1b46615fc2c\"><span style=\"color: #181818;\">The AI agent or application you’re using</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #181818;\" data-list-item-id=\"e03ce41e16bcb81c929a57ea00cc80c10\"><span style=\"color: #181818;\">Whether you’re using Upwork as a freelancer, client, or agency</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #181818;\" data-list-item-id=\"e18ff1757986e7735f94ed4cf10abb8d2\"><span style=\"color: #181818;\">What you were trying to do</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #181818;\" data-list-item-id=\"e0bb0146ce40e19ebc8c9aaa33581ca70\"><span style=\"color: #181818;\">The exact error you received and when it happened</span></li>\n<li class=\"wysiwyg-list-color\" style=\"--wysiwyg-list-marker-color: #181818;\" data-list-item-id=\"e8f0ae61d0dd262e151a277c73bdf5ce1\"><span style=\"color: #181818;\">A screenshot or trace ID, if available</span></li>\n</ul><p><span style=\"color: #181818;\">Never send your password, OAuth token, cookies, or other login credentials.</span></p><p> </p><h2 id=\"h_01M3W1FH35JH7H3G3HE489Q0EE\"><span style=\"color: #181818;\">Frequently Asked Questions</span></h2><h3 id=\"h_01M3W1ETT7AD47WT7VX428MZ0F\"><span style=\"color: #181818;\"><strong>Can an AI agent draft and submit a proposal through MCP?</strong></span></h3><p><span style=\"color: #181818;\">Yes. An AI agent can help you draft a proposal. Before submitting it, you'll review the proposal details and explicitly confirm the submission.</span></p><h3 id=\"h_01M3W1ER5F1WQFQQH8X0G0CTZ3\"><span style=\"color: #181818;\"><strong>My proposal confirmation failed. Was my proposal submitted?</strong></span></h3><p><span style=\"color: #181818;\">Don't assume your proposal was submitted. Check your submitted or pending proposals and your Connects balance.</span></p><p><span style=\"color: #181818;\">If you don't see the proposal or a change to your Connects balance, don't repeatedly retry the submission. Contact Upwork Support and include the job reference, the error you received, when it happened, and a trace ID, if available.</span></p><h3 id=\"h_01M3W1ER5G20XVJCVRSYPS22N1\"><span style=\"color: #181818;\"><strong>Can I create or edit Project Catalog projects through MCP?</strong></span></h3><p><span style=\"color: #181818;\">Not currently. You can’t use MCP to create or edit Project Catalog projects, add media, submit a draft, or manage a project’s status.</span></p>","user_segment_ids":[]}}