Keyword MCP server
23 operations0 webhooks
Rank tracking with Keyword.com - manage projects and their keywords, add and refresh keywords, and read rankings, movement metrics, rank history, competitors, tracked regions, top pages and Share of Voice history.
Try Keyword with your agent
Connect Keyword, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Keyword on my account, then run one read-only example and show me the result.
Keyword tools and triggers
Tools are what your agent can do in Keyword through Corsair's MCP server. Triggers are the Keyword events a routine can start from.
Keywords
- AddWrite
Add keywords to a project, each with its domain, region and language. Adding a keyword already tracked returns the existing one
keywords.add
- Bulk DeleteDestructive
Delete many keywords from one project in a single call; their history is lost
keywords.bulkDelete
- Bulk UpdateWrite
Apply the same domain, region, tags or status to many keywords in one project
keywords.bulkUpdate
- DeleteDestructive
Delete one keyword and its ranking history; it cannot be restored
keywords.delete
- GetRead-only
One keyword with its rank, metrics and rank history
keywords.get
- ListRead-only
Every keyword in a project or group with its rank, best rank, search volume and trend, read as of a given day
keywords.list
- RefreshDestructive
Queue keywords for an on-demand rank check; spends the plan’s daily refresh quota. The whole request is refused if the quota would be exceeded
keywords.refresh
- UpdateWrite
Change a keyword’s domain, region, tags, status, baseline or favourite flag
keywords.update
Projects
- ArchiveWrite
Archive a project or subproject: it stops updating until `projects.restore` brings it back. Keyword refuses to archive the account’s only active top-level project
projects.archive
- CreateWrite
Create a project, or a subproject from a `Parent[sub]Child` name; the parent must exist first
projects.create
- DeleteDestructive
Delete a project with every keyword and its ranking history; it cannot be restored
projects.delete
- GetRead-only
One project or subproject with its tags and counts
projects.get
- ListRead-only
Every project and subproject with its tags and keyword counts; a subproject is named `Parent[sub]Child`
projects.list
- RestoreWrite
Undo an archive, bringing the project and its keywords back
projects.restore
Metrics
- CompetitorsRead-only
The top competing URLs for one keyword in a date window, with each result’s type and position
metrics.competitors
- GetRead-only
Keyword movement for a project, group or tag: how many sit in each top-N bucket and how that changed day over day
metrics.get
Sharing
- GetRead-only
A project’s shared-report settings: whether the share link is on, its hash, whether it needs a password, and what the report shows
sharing.get
- UpdateWrite
Turn a project’s share link on or off, set or clear its password, or toggle what the shared report shows. Everything except the on/off switch needs Keyword’s white-label permission
sharing.update
Account
- GetRead-only
The token’s own user, optionally with the subscription block
account.get
Mindshare
- HistoryRead-only
Share of Voice over a date window, read from Keyword’s cache
mindshare.history
Rank Chart
- GetRead-only
Daily rank history for a set of keywords over a number of days; Keyword refuses a call covering more than 400,000 keyword-days
rankChart.get
Ranking Urls
- ListRead-only
The pages that rank best for a project, with their average position and total search volume, 10 to a page
rankingUrls.list
Regions
- ListRead-only
The Google regions a project tracks, with each one’s language and keyword count
regions.list
Connect Keyword to Claude, ChatGPT or Cursor
- 1
Connect Keyword in Corsair
Add your Keyword API key once in Corsair. Corsair stores the credential encrypted and makes the Keyword API calls for your agent, so it never goes into a prompt or a config file. Connect Keyword
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Keyword. On a ChatGPT personal plan, connect Keyword here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Keyword's read and write operations run right away and its 4 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/keyword, add the Keyword plugin, and connect with an API key. Then call methods like corsair.keyword.api.account.get() from your app. Corsair keeps each tenant isolated.
Yes. Keyword requires an API key from your Keyword account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Keyword, GitHub, Notion, Stripe, and the rest. Trigger Keyword from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for rank tracking with Keyword.com - manage projects and their keywords, add and refresh keywords, and read rankings, movement metrics, rank history, competitors, tracked regions, top pages and Share of Voice history. Common builds include sync jobs, admin tooling, and agents that call Keyword APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Keyword API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/keyword in the open repo. When Keyword ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Keyword data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Keyword data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Keyword on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 4 destructive Keyword operations. You can change a link's mode at hub.corsair.dev/me.