Serpel MCP server
Commit Oct 11, 2026Connects AI assistants to SEO data including rankings, search performance, keyword opportunities, competitor analysis, and site audits.
Also known as Serpelapp/serpel-plugin, serpel-plugin
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Oct 11, 2026
- License
- MIT
What is Serpel MCP?
Serpel connects AI assistants to SEO data including rankings, search performance, keyword opportunities, competitor analysis, and site audits. It exposes 13 tools, such as list_projects, get_project_overview, get_keyword_rankings.
Summary generated from the project's README
About Serpel MCP server
SEO professionals and developers can query website performance data directly through AI assistants like Claude, ChatGPT, Cursor, and GitHub Copilot. By connecting to the Serpel MCP server via a remote HTTP connection, these assistants gain access to specific metrics including keyword rankings, search console clicks, and technical crawl issues. The server works with OAuth sign-in or an API token with mcp:read permissions to ensure users only access their own project data.
Users can perform deep analysis using tools such as get_keyword_rankings, analyze_competitors, and get_ai_visibility to see how often a site is mentioned in ChatGPT or Google AI Overviews. While most tools are free, the research_keywords tool uses account credits to provide search volume and intent metrics. Most tool outputs are limited to 25 rows per list. In supported interfaces like Claude or ChatGPT, certain tools like get_crawl_issues display results as interactive cards, while text-based clients like the Gemini CLI receive the data as standard text.
What you can do with it
- 1Identify quick keyword winsAsk the assistant to find queries currently ranking in positions 4 to 20 that have high impressions.
- 2Monitor AI search visibilityCheck how frequently your website is cited within ChatGPT answers and Google AI Overviews.
- 3Audit technical SEO issuesRequest a summary of the latest crawl to determine which technical problems require immediate attention.
- 4Analyze competitor performanceCompare your website visibility against competitors using stored search results.
Written from the project's README. Every use case is checked against a quote from it.
How to install Serpel MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Serpel MCP in Claude Code
$ claude mcp add --transport http serpel-plugin https://serpel.app/mcpInstall Serpel MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"serpel-plugin": {
"url": "https://serpel.app/mcp"
}
}
}Install Serpel MCP in VS Code
.vscode/mcp.json
{
"servers": {
"serpel-plugin": {
"type": "http",
"url": "https://serpel.app/mcp"
}
}
}Install Serpel MCP in VS Code CLI
$ code --add-mcp '{"name":"serpel-plugin","type":"http","url":"https://serpel.app/mcp"}'Install Serpel MCP in Codex
$ codex mcp add serpel-plugin --url https://serpel.app/mcpInstall Serpel MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.serpel-plugin] url = "https://serpel.app/mcp"
Install Serpel MCP in Gemini CLI
$ gemini mcp add -s user --transport http serpel-plugin https://serpel.app/mcpInstall Serpel MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"serpel-plugin": {
"url": "https://serpel.app/mcp",
"type": "http"
}
}
}Serpel MCP tools 13
Detected from the READMElist_projectsget_project_overviewget_keyword_rankingsget_search_performancefind_keyword_opportunitiesanalyze_competitorsget_crawl_issuesget_ai_visibilityget_job_statusget_seo_recommendationsget_codebase_overviewget_conversion_performance
Show all 13 toolsShow fewer tools
research_keywords
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableserpelapp/serpel-plugin is public and reachablegithub.com/serpelapp/serpel-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-11github.com/serpelapp/serpel-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSerpel plugin for AI assistants
Ask Claude, ChatGPT, Codex, Cursor, GitHub Copilot, VS Code or the Gemini CLI about the SEO data of your own websites. The plugin connects your assistant to the Serpel MCP server and adds a skill that explains which tool to use when.
The plugin contains manifests and one skill only. It has no program code and no hooks.
What you can ask
- Which projects do I have, and how healthy is each one?
- Which keywords moved up or down since the last rank check?
- What do Google Search Console clicks and impressions look like compared with the previous period?
- Which queries rank on positions 4 to 20 and are quick wins?
- Where do my competitors rank better than I do?
- Which technical issues did the latest crawl find, and what should I fix first?
- How often is my site cited or mentioned in ChatGPT answers and in Google AI Overviews?
- Has my crawl or rank check finished?
- Optional, uses credits: keyword ideas with search volume, difficulty and intent.
Tools
| Tool | Purpose | Costs |
|---|---|---|
list_projects |
Projects of your account with IDs and domains | free |
get_project_overview |
Audit score, rankings, AI visibility, tasks and next steps | free |
get_keyword_rankings |
Tracked keywords with positions and changes | free |
get_search_performance |
Search Console or Bing clicks, impressions, CTR, position | free |
find_keyword_opportunities |
Queries on positions 4 to 20 with impressions | free |
analyze_competitors |
Visibility and head-to-head comparison from stored results | free |
get_crawl_issues |
Issues of the latest crawl by severity | free |
get_ai_visibility |
Citations and mentions in ChatGPT answers and Google AI Overviews | free |
get_job_status |
Status and result of a background job | free |
get_seo_recommendations |
Prioritised recommendations with impact, effort and evidence | free |
get_codebase_overview |
Routes, metadata and live-page mapping from the codebase snapshot | free |
get_conversion_performance |
Sessions, conversions and conversion rate per landing page | free |
research_keywords |
Keyword ideas and metrics | credits |
All lists contain at most 25 rows. Tools only read data of projects you can access, and they never change your website.
ChatGPT does not offer research_keywords. In all other clients it needs an active Starter or Pro plan and the workspace setting “Agents can spend credits”. A daily credit limit for agents applies, and credits come from your monthly plan allowance first.
Interactive cards
In apps that can display MCP Apps, such as ChatGPT and Claude, four tools show their result as an interactive card: get_keyword_rankings, get_crawl_issues, find_keyword_opportunities and get_ai_visibility. Every other client, for example Claude Code, Cursor, Codex and the Gemini CLI, gets the same data as text. The cards load no external resources and open links only to the Serpel dashboard.
Set up
The server address is https://serpel.app/mcp (Streamable HTTP). Clients that support OAuth open a browser window for the sign-in on first use. Alternatively create an API token with the mcp:read permission (plus the read permissions for the data you want to use) in the Serpel dashboard under Settings, API tokens, and send it as Authorization: Bearer <token>.
Claude Code
claude mcp add --transport http serpel https://serpel.app/mcp
To load the plugin with its skill from a local checkout: claude --plugin-dir ./serpel-plugin.
ChatGPT and Codex
Install the plugin from the plugin directory, or add the remote MCP server https://serpel.app/mcp in the connector settings and sign in with your Serpel account.
Cursor
Add the server in .cursor/mcp.json or install the plugin from the marketplace:
{
"mcpServers": {
"serpel": { "url": "https://serpel.app/mcp" }
}
}
VS Code with GitHub Copilot
Add the server in .vscode/mcp.json or install it from the MCP gallery (@mcp):
{
"servers": {
"serpel": { "type": "http", "url": "https://serpel.app/mcp" }
}
}
Gemini CLI
gemini extensions install https://github.com/Serpelapp/serpel-plugin
Files
| File | For |
|---|---|
plugin.json, mcp.json, skills/serpel/SKILL.md |
Agent Plugins 1.0: ChatGPT, Codex, Cursor, GitHub Copilot, VS Code |
chatGpt/skills/serpel/SKILL.md |
Skill for the ChatGPT app directory, without keyword research, which ChatGPT does not offer |
.claude-plugin/plugin.json, .mcp.json |
Claude Code |
gemini-extension.json |
Gemini CLI |
server.json |
Official MCP registry, name app.serpel/mcp |
assets/ |
Icon |
All manifests carry the same version.
Privacy and support
- Privacy policy: https://serpel.app/privacy
- Terms: https://serpel.app/terms
- Support and contact: https://serpel.app/about#how-can-you-contact-serpel
- Legal notice: https://serpel.app/imprint
Tool results contain data from your Serpel account only. Disconnect a client at any time in the Serpel dashboard under Settings, API, connected apps.
Serpel MCP questions
How do I add Serpel MCP to Claude Code?
Run claude mcp add --transport http serpel-plugin https://serpel.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Serpel MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Serpel MCP provide?
It exposes 13 tools, including list_projects, get_project_overview, get_keyword_rankings, get_search_performance, find_keyword_opportunities.
What kind of SEO data can I ask about?
You can query keyword rankings, Google Search Console clicks and impressions, competitor visibility, technical crawl issues, and AI visibility in ChatGPT or Google AI Overviews.
Does the server change my website?
No, the tools are read-only and only access data from projects you have permission to view.
How do I authenticate with the Serpel MCP server?
You can use OAuth via a browser window on first use, or create an API token with 'mcp:read' permissions in the Serpel dashboard.
Are there any costs associated with the tools?
Most tools like project overviews and keyword rankings are free, but the research_keywords tool uses credits.