Connect an agent to CiteSonar

Add CiteSonar to an MCP client with one command. Choose how the agent signs in, then see the scope and tools it gets.

Connect

Sign in from your client

Your client opens a sign-in window and asks you to approve a scope. There is no key to copy.

claude mcp add --transport http citesonar https://citesonar.com/mcp

Use an API key

Create a key in your workspace, then swap it in for the placeholder in the command.

claude mcp add --transport http citesonar https://citesonar.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Create a workspace

Try it with no key

A read-only sample workspace for a fictional coffee roaster. It answers these tools:

get_action
get_brief
list_actions
list_sites

claude mcp add --transport http citesonar-demo https://citesonar.com/demo/mcp

Open the sample workspace

Install the skills

These commands require a local repository checkout containing integrations/agent-kit. Run them from the repository root. Connect the MCP server separately; installing skills does not grant access.

Claude Code

/plugin marketplace add ./integrations/agent-kit
/plugin install citesonar@citesonar

Codex

mkdir -p .agents/skills
cp -R ./integrations/agent-kit/plugins/citesonar/skills/. .agents/skills/

Cursor

mkdir -p .cursor/skills
cp -R ./integrations/agent-kit/plugins/citesonar/skills/. .cursor/skills/

SKILL.md paths

citesonar-loop

plugins/citesonar/skills/citesonar-loop/SKILL.md

audit-and-fix

plugins/citesonar/skills/audit-and-fix/SKILL.md

citability

plugins/citesonar/skills/citability/SKILL.md

striking-distance-metas

plugins/citesonar/skills/striking-distance-metas/SKILL.md

verify-and-measure

plugins/citesonar/skills/verify-and-measure/SKILL.md

Skills ask for confirmation before act or metered tools. CiteSonar provides artifacts; deployment stays with you or your separately authorized implementation agent.

Scopes

A tool call needs the scope shown beside it. Tools at each scope:

read27
act12
admin18

Tools

Every tool an agent can call, grouped by subject. A metered tool returns a quote from the estimate tool before it runs.

Onboarding

Tool	Effect	Scope	Note
`add_site`	write	admin
`check_dns_verification`	write	admin
`get_onboarding_status`	read	read
`import_rank_history`	metered	admin	Quoted by estimate_cost before it runs
`run_first_audit`	write	admin
`set_onboarding_pages`	write	admin
`set_onboarding_signals`	write	admin
`start_dns_verification`	write	admin

Site

Tool	Effect	Scope
`annotate`	write	act
`get_context`	read	read
`list_alerts`	read	read
`list_sites`	read	read
`set_context`	write	act

Visibility

Tool	Effect	Scope	Note
`get_citation_receipt`	read	read
`get_citations`	read	read
`get_crawler_activity`	read	read
`get_cwv`	read	read
`get_gsc`	read	read
`get_pipeline`	read	read
`get_rankings`	read	read
`get_readiness`	read	read
`get_reconciliation`	read	read
`get_serp`	metered	read	Quoted by estimate_cost before it runs
`get_visibility`	read	read
`keyword_gap`	read	act
`research_keywords`	read	act
`run_citation_check`	metered	act	Quoted by estimate_cost before it runs

Actions

Tool	Effect	Scope	Note
`accept_action`	write	act
`dismiss_action`	write	act
`estimate_action`	read	read
`generate_artifact`	metered	act	Quoted by estimate_cost before it runs
`get_action`	read	read
`get_brief`	read	read
`list_actions`	read	read
`mark_applied`	write	act

Spend

Tool	Effect	Scope	Note
`estimate_cost`	read	`get_serp` read `research_keywords` act `keyword_gap` act `generate_artifact` act `run_citation_check` act `import_rank_history` admin
`get_spend`	read	read

Settings

Tool	Effect	Scope
`get_autopilot`	read	read
`get_bing_connection`	read	read
`get_engines`	read	read
`get_notification_prefs`	read	read
`invite_member`	write	admin
`list_api_keys`	read	read
`list_google_connections`	read	read
`list_members`	read	admin
`remove_member`	destructive	admin
`revoke_api_key`	destructive	admin
`revoke_bing_connection`	destructive	admin
`revoke_google_connection`	destructive	admin
`set_account_locale`	write	act
`set_autopilot`	write	admin
`set_budget`	write	admin
`set_engines`	write	admin
`set_member_role`	write	admin
`set_notification_prefs`	write	act