# Cursor

Configure the Data MCP server in Cursor's `mcp.json`, with OAuth sign-in or an API key read from your environment.

## Prerequisites

- Cursor with MCP support.
- For an API key: a key from **API keys** in the console, exported as `AUTOUNCLE_API_KEY` in the environment Cursor starts from. Start with a test key.

Cursor reads `~/.cursor/mcp.json` for all projects and `.cursor/mcp.json` inside a project. Use the project file to share the configuration with your team, and keep keys out of it.

## Connect with an API key

```json
{
  "mcpServers": {
    "autouncle-data": {
      "url": "https://data-services.autouncle.com/mcp",
      "headers": { "Authorization": "Bearer ${env:AUTOUNCLE_API_KEY}" }
    }
  }
}
```

Cursor replaces `${env:AUTOUNCLE_API_KEY}` with the variable's value when it starts the server, so the file itself contains no secret. Restart Cursor (or reload the MCP servers) after changing the variable.

## Connect with OAuth

Leave out the `headers` block:

```json
{
  "mcpServers": {
    "autouncle-data": {
      "url": "https://data-services.autouncle.com/mcp"
    }
  }
}
```

Cursor discovers AutoUncle's authorization server from the `401` response and registers itself as a public client through dynamic registration. Sign in with your AutoUncle account, choose the organization and approve the scopes. Check Cursor's MCP documentation for where it shows the sign-in prompt in your version. OAuth valuations are **live** and use the organization's credits.

## Verify the connection

Open Cursor's MCP settings and check that `autouncle-data` is enabled and lists eight tools. Then ask the agent:

> Call get_account on autouncle-data and tell me the key mode and scopes.

## Troubleshooting

| Symptom | Fix |
| --- | --- |
| `401 invalid_api_key` | `AUTOUNCLE_API_KEY` is empty or wrong in the environment Cursor was started from. Start Cursor from a shell where it is set, then reload. |
| No tools listed | Check the JSON is valid and the URL is exactly `https://data-services.autouncle.com/mcp`. |
| Results are live, not simulated | You are using OAuth or a live key. Use a test key header for free results. |
| `insufficient_scope` | The key or OAuth grant lacks the tool's scope. |

## Next steps

- [Agent skill](/docs/skill): Cursor agents can also read the skill to integrate the REST API.
- [Safety & spend control](/docs/mcp/safety)

Sources: [Cursor MCP documentation](https://cursor.com/docs/context/mcp).
