Quickstart

1. Issue an API token

1. Open the TrustData dashboard and go to Organization Settings → Developer.
2. In the API tokens card, give the token a name (e.g. "Claude Desktop, home"), pick a rate tier, and select scopes.
   • Use the SEO × GEO playbook preset for the recommended GEO/SEO scope set.
   • Use All scopes if you're unsure and want to hand the agent everything you can.
3. Click Issue token.
4. Copy the td_live_… token that appears. This is the only time it's shown. Store it in a password manager.

2. Connect your agent

After issuing, the dashboard shows a Connect an agent panel with one-click install snippets per client. You can also paste the snippets below directly.

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json                      (Windows)
{
  "mcpServers": {
    "trustdata": {
      "url": "https://app.trustdata.tech/mcp/",
      "headers": {
        "Authorization": "Bearer td_live_YOUR_TOKEN"
      }
    }
  }
}

claude mcp add --transport http trustdata https://app.trustdata.tech/mcp/ \
  --header "Authorization: Bearer td_live_YOUR_TOKEN"

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "trustdata": {
      "url": "https://app.trustdata.tech/mcp/",
      "headers": { "Authorization": "Bearer td_live_YOUR_TOKEN" }
    }
  }
}

// ~/.gemini/settings.json
{
  "mcpServers": {
    "trustdata": {
      "httpUrl": "https://app.trustdata.tech/mcp/",
      "headers": {
        "Authorization": "Bearer td_live_YOUR_TOKEN"
      }
    }
  }
}

Settings → Connectors → Add MCP server

  URL:   https://app.trustdata.tech/mcp/
  Auth:  Bearer token
  Token: td_live_YOUR_TOKEN

Restart the agent. You should see a trustdata connection in its MCP / tools panel.

3. Verify with a first tool call

Ask your agent something that exercises a tool:

"List the TrustData analytics queries available to me."

The agent will call list_analytics_queries and return the set of query types your token's scopes allow. If you see a list of query types (campaigns, channel_summary, geo_visibility, etc.), you're connected.

4. Try the playbook

The real value is letting the agent drive an end-to-end loop. Open the SEO × GEO playbook and paste it as a system prompt. The agent will diagnose, propose hypotheses, and record trackable recommendations in one conversation.

Rate limits

run_probe is separately metered against your GEO add-on's monthly engine-call allowance.

Troubleshooting

Need help?

• Revoke a compromised token: Developer → API tokens → Revoke. Revocation is immediate.
• Support: [email protected]