Tools

The @cite42/mcp server exposes market-data tools for AI search, SEO keywords, trends, and creator workflows. You don’t call them by hand; describe what you want and your agent picks the tool.

The tools

The server exposes primitive data tools plus workflow contracts. You don’t invoke them directly; you ask your agent in plain English, it picks the right tool, and it answers you in plain English from the JSON the tool returns. You never handle the raw response yourself. Each tool has its own page with an example prompt and the JSON it hands back:

The primitives are for AI-search, citation, SEO, keyword, trend, and market-research data, not general coding or writing. Code-related research is still a valid use case when the goal is to compare what the models recommend or cite for an implementation decision.

Search: ask any question across the models. · Rankings: how brands rank in AI answers. · Compare: head-to-head vs a competitor set. · Citations: which sources the models cite. · Sentiment: how the models talk about a brand. · Keywords: search volume and related ideas. · Trends: Google Trends interest over time. · Reddit Trends: conversation signals. · YouTube Trends: video-market signals.

Reading your balance (/v1/usage) is a read-only call, not a tool; check it from the dashboard or over REST.

Example prompts

Once the server is connected, you talk to your agent normally — it picks the tool. These cover the main tool families; each one names the tool it triggers so you can see the mapping:

# cite42_search — one question, every model, with sources
Ask ChatGPT, Claude, and Perplexity "what is the best project management tool for agencies" and show me which sources each one cited.

# cite42_rankings — where a brand places in AI answers
How often does Asana get mentioned across the AI models for agency project management, and what average position does it hold?

# cite42_find_ai_citation_gaps — queries where AI cites rivals but not you
Find queries about time tracking software where the AI models cite my competitors but never link to toggl.com.

# cite42_keywords + cite42_trends — classic SEO demand data
What is the monthly search volume and CPC for "ai visibility tracking", and is interest rising or falling over the last 12 months?

# cite42_reddit_trends — what the audience actually complains about
What are people on Reddit frustrated about when it comes to SEO reporting tools right now?

# cite42_pricing — free, costs 0 credits
Before we run anything: what would it cost in Cite42 credits to check rankings across all five models for 20 queries?

Every tool page linked above carries its own prompt plus the JSON the agent reasons over.

Choosing models

The five AI-model tools (search, rankings, compare, citations, sentiment) take an optional models list, so you can say “just ChatGPT” and pay for only that selected model. Omit it and the tool queries all five. Keywords, trends, Reddit Trends, and YouTube Trends are flat-priced data tools; workflow prices are calculated from their live primitive endpoints and selected model rates. See Per-model pricing.

Billing

MCP calls bill exactly like REST: per model queried, from the same prepaid balance. No agent-seat fee, no MCP markup. Each tool result includes the cost and remaining balance. See Credits & billing.