> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useagents.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Connect the UseAgents MCP server to Cursor IDE using the settings UI or a JSON config file.

Connect UseAgents to Cursor so your AI assistant can discover verified developer tools from the registry.

<Note>
  UseAgents is **currently free** during our public beta. No API key is required. Requests are subject to [rate limits](/api-reference/rate-limit).
</Note>

## Option 1: Settings UI

1. Open Cursor and press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux).
2. Search for **Cursor Settings** and open it.
3. Navigate to **Tools & MCP**.
4. Click **Add New MCP Server**.
5. Set the name to `UseAgents` and the type to **URL**.
6. Paste the server URL:

```text theme={null}
https://mcp.useagents.site/mcp
```

7. Save and confirm the server appears in the list with a green status indicator.

## Option 2: Project-level config

Create or edit `.cursor/mcp.json` in your project root:

```json theme={null}
{
  "mcpServers": {
    "UseAgents": {
      "url": "https://mcp.useagents.site/mcp"
    }
  }
}
```

This makes UseAgents available only in that project.

## Option 3: Global config

Edit `~/.cursor/mcp.json` to make UseAgents available in all projects:

```json theme={null}
{
  "mcpServers": {
    "UseAgents": {
      "url": "https://mcp.useagents.site/mcp"
    }
  }
}
```

<Tip>
  If the same server name exists in both the global and project-level config, the **project-level config takes priority**.
</Tip>

## Verify the connection

1. Restart Cursor after saving the config.
2. Open **Tools & MCP** in settings and confirm `UseAgents` shows a green status.
3. In Agent mode, ask Cursor to search for a tool — for example: *"Use UseAgents to find a TypeScript SDK for Stripe webhooks."*
4. Confirm you receive structured tool results.

## Troubleshooting

* **Server not appearing**: Restart Cursor after editing the config file.
* **Red status indicator**: Check that the URL is exactly `https://mcp.useagents.site/mcp` with no extra whitespace.
* **No tools returned**: Make sure you are using Cursor's Agent mode, not the standard chat.

## Next steps

* [MCP Tools Reference](/mcp/tools-reference/introduction) to understand the available tools
* [Rate Limits](/api-reference/rate-limit) for request limits during the beta