Use TopCited from your agent

CLI

One command to install, one to sign in. Every command prints JSON when piped, waits on long jobs with --wait, and shows the T-coin cost first with --dry-run.

curl -fsSL https://topcited.ai/install.sh | sh

irm https://topcited.ai/install.ps1 | iex

topcited auth login

topcited brand list
topcited monitor run <query-set> --dry-run   # T-coin cost, spends nothing
topcited monitor run <query-set> --wait
topcited monitor results --json

In CI or a headless agent, set TOPCITED_API_KEY instead of signing in.

Hosted MCP server

Connect any MCP client to TopCited's tools: brand visibility, monitoring runs, gaps and share of voice, site audits, recommendations and reports. It uses the same account, plan and T-coin balance as the dashboard.

claude mcp add --transport http topcited https://api.topcited.ai/mcp --header "Authorization: Bearer $TOPCITED_API_KEY"

{
  "mcpServers": {
    "topcited": {
      "url": "https://api.topcited.ai/mcp",
      "headers": {
        "Authorization": "Bearer tc_your_api_key"
      }
    }
  }
}

Create an API key in Settings → API keys. The key gives access to your whole account, so keep it out of shared config files.

Agent skills

Open-source SEO/GEO knowledge and TopCited workflows your agent can load, from an expert knowledge base to a step-by-step visibility workflow.

/plugin marketplace add TopCited/topcited-skills
/plugin install topcited-skills@topcited

https://raw.githubusercontent.com/TopCited/topcited-skills/main/skills/topcited-api/SKILL.md

API

The CLI and MCP server are built on a public, versioned OpenAPI contract. Authenticate with a bearer API key. Public operations only change additively.

https://api.topcited.ai/api/v1/openapi.public.json