Skip to main content
Connect the UseAgents MCP server to your agent so it can search the UseAgents registry for verified tools. After setup, your agent can use natural language to find real SDKs, APIs, CLIs, and libraries instead of guessing.

​
Before you begin

  • API key – Create one at useagents.site/dashboard → Settings → API Keys. Keys are organization-scoped (WorkOS).
  • MCP support – Your agent must support the Model Context Protocol (MCP).

​
Connection details

SettingValue
URLhttps://mcp.useagents.site/mcp
AuthAPI key in the x-api-key header

​
Add the server to your agent

Add the UseAgents MCP server to your agent’s config. Pass your API key in the headers.

​
Cursor

In Cursor settings (or .cursor/mcp.json), add: 
{
  "mcpServers": {
    "useagents": {
      "url": "https://mcp.useagents.site/mcp",
      "headers": {
        "x-api-key": "USEAGENTS_API_KEY"
      }
    }
  }
}
Replace USEAGENTS_API_KEY with the API key from your dashboard.

​
Claude Desktop

In your Claude Desktop config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on macOS): 
{
  "mcpServers": {
    "useagents": {
      "url": "https://mcp.useagents.site/mcp",
      "headers": {
        "x-api-key": "USEAGENTS_API_KEY"
      }
    }
  }
}

​
Windsurf

Add the same mcpServers block to your Windsurf MCP configuration with the UseAgents URL and x-api-key header.

​
Generic MCP config

Any MCP client that supports HTTP transport and custom headers can use: 
{
  "mcpServers": {
    "useagents": {
      "url": "https://mcp.useagents.site/mcp",
      "headers": {
        "x-api-key": "USEAGENTS_API_KEY"
      }
    }
  }
}

​
Verify the connection

After saving the config and restarting your client:
  1. Open your MCP-compatible agent.
  2. Confirm the useagents server appears in the MCP server list, if your client shows one.
  3. Ask the agent to search for a tool such as “find a TypeScript SDK for Stripe webhooks” using search_tools.
  4. Confirm the response includes structured tool results rather than a connection error.

​
Troubleshooting

  • Authentication failed: Verify the x-api-key header is present and the key belongs to the correct organization.
  • Server does not appear: Restart the MCP client after editing the config file.
  • Requests fail unexpectedly: Re-copy the URL exactly as https://mcp.useagents.site/mcp and remove extra whitespace or trailing characters.

​
Get an API key

  1. Go to useagents.site and sign in.
  2. Create or select an organization.
  3. Open Settings → API Keys.
  4. Create a new API key and copy it immediately. You will not be able to see it again.
API keys are organization-scoped. Use the same key for all tools in that organization.

​
Next steps