Skip to content
MCP & agents / CursorView Markdown ↗
Beta

AutoUncle Data Services is in beta. The API, MCP tools and agent skill may change often, including breaking changes, until version 1.0. Read the changelog before you upgrade an integration.

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

{
  "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:

{
  "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

Sources: Cursor MCP documentation.