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](/content/dashboard/index.html) → Settings → API Keys. Keys are organization-scoped (WorkOS).
- **MCP support** – Your agent must support the Model Context Protocol (MCP).

## Connection details

| Setting | Value |
| --- | --- |
| **URL** | `https://mcp.useagents.site/mcp` |
| **Auth** | API 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](/content/dashboard/index.html).

### 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](/content/site-root.html) 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

- [MCP Tools Reference](/content/docs/mcp/tools-reference/introduction/index.html) to learn what the server exposes
- [API Keys](/content/docs/reference/api-keys/index.html) for credential management and security guidance