50Pros Developers

Extend automatic discovery with live 50Pros tools

Public 50Pros profiles and case studies are already available to web-connected AI services without a buyer account or integration. The optional MCP server adds live search, comparison, and buyer-authorized project workflows. Private tools use OAuth 2.1 with PKCE or a scoped API key.

View the product Manage buyer keys Manage agency keys

MCP endpoint

Streamable HTTP

https://www.50pros.com/api/mcp

Add this URL as a remote MCP server in a compatible AI client. The server advertises OAuth metadata when a private tool needs buyer authorization.

{
  "mcpServers": {
    "50pros": {
      "type": "http",
      "url": "https://www.50pros.com/api/mcp"
    }
  }
}

MCP tools

Public and scoped capabilities

search_agenciesPublic

Natural-language agency search with structured filters and transparent fit reasons.

get_agency_detailsPublic

Public services, industries, reviews, case studies, budget fields, and availability.

compare_agenciesPublic

Side-by-side comparison for two to five agency profiles.

list_service_categoriesPublic

The active 50Pros service taxonomy and stable category slugs.

list_my_project_briefsprojects:read

The connected buyer's briefs, status, invitations, and responses.

get_project_briefprojects:read

One buyer-owned brief with current recommended agency matches.

propose_project_briefprojects:propose

Creates a pending buyer approval. It does not publish the brief.

propose_agency_outreachprojects:propose

Creates a pending buyer approval. It does not contact an agency.

Live agent search

Public MCP discovery

See the same evidence an AI agent receives

Test the anonymous agency-search experience backed by the public discovery tools.

OAuth 2.1

Dynamic registration and PKCE

50Pros supports public dynamic client registration and authorization code flow with PKCE S256. Tokens are scoped 50Pros API keys with a 90-day expiration and can be revoked by the buyer.

Authorization metadata: https://www.50pros.com/.well-known/oauth-authorization-server
Protected resource: https://www.50pros.com/.well-known/oauth-protected-resource
Registration: https://www.50pros.com/api/oauth/register

Available scopes

agencies:read

Search and compare public agency profiles, services, case studies, and reviews.

projects:read

Read your 50Pros project briefs, matching status, and agency responses.

projects:propose

Prepare project briefs and agency outreach for your approval. This cannot publish or contact an agency without your confirmation.

Human approval contract

Consequential actions are held

Agent tools may prepare a project brief or agency outreach, but those calls only create an auditable pending action. A signed-in buyer must approve it in 50Pros before the existing publishing, matching, notification, and invitation workflows run.

The agent cannot accept proposals, sign agreements, purchase services, or move funds in this release.

Direct MCP request

Anonymous agency search

curl -X POST https://www.50pros.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_agencies",
      "arguments": {
        "query": "B2B video production for an enterprise launch",
        "verifiedOnly": true,
        "limit": 5
      }
    }
  }'

REST API

Existing application integration

REST requests require a Bearer API key with agencies:read. Legacy keys with read remain compatible.

GET/api/v1/agencies

List active agencies with optional filters.

GET/api/v1/agencies/:slug

Get one public agency profile.

GET/api/v1/categories

Get the full service taxonomy tree.

Limits

API keys default to 60 requests per minute.

Anonymous MCP discovery is rate limited by network address.

Error responses use HTTP status codes for authentication and transport failures. MCP method and tool errors use JSON-RPC 2.0 response envelopes.