Skip to main content
Glama
Sign In
AgentSEO MCP Server

AgentSEO MCP Server

by AgentSEO-dev
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

@agentseo/mcp-server

The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.

Hosted remote MCP

AgentSEO also exposes a hosted remote MCP endpoint:

https://www.agentseo.dev/mcp

Use a server-side API key with no allowed domains.

Claude Code

claude mcp add --transport http agentseo https://www.agentseo.dev/mcp \
  --header "Authorization: Bearer sk_live_your_key" \
  --header "x-project-id: client-alpha" \
  --header "x-workflow-id: nightly-refresh"

Cursor

{
  "mcpServers": {
    "agentseo": {
      "url": "https://www.agentseo.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key",
        "x-project-id": "client-alpha",
        "x-workflow-id": "nightly-refresh"
      }
    }
  }
}

Related MCP server: Serpstat MCP Server

Quickstart (Claude Desktop / Cursor)

1. Set your API key

export AGENTSEO_API_KEY="sk_live_your_key"

2. Add AgentSEO MCP server to your MCP config

For Claude Desktop, add this to claude_desktop_config.json. For Cursor, add the same block in MCP settings:

{
  "mcpServers": {
    "agentseo": {
      "command": "npx",
      "args": ["-y", "@agentseo/mcp-server"],
      "env": {
        "AGENTSEO_API_KEY": "sk_live_your_key",
        "AGENTSEO_API_URL": "https://www.agentseo.dev/api/v1",
        "AGENTSEO_PROJECT_ID": "client-alpha",
        "AGENTSEO_WORKFLOW_ID": "nightly-refresh"
      }
    }
  }
}

3. Restart your MCP client

After restart, ask Claude or Cursor:

Run agentseo_local_audit for Example Dental in Austin, Texas, United States

Environment Variables

  • AGENTSEO_API_KEY (required): Your workspace API key.

  • AGENTSEO_API_URL (optional): Defaults to https://www.agentseo.dev/api/v1.

    • For local development use http://localhost:3000/api/v1.

  • AGENTSEO_PROJECT_ID (optional): Default project attribution for all tool calls.

  • AGENTSEO_WORKFLOW_ID (optional): Default workflow attribution for all tool calls.

Available Tools

Safety and input metadata

All 45 tools declare explicit MCP readOnlyHint, destructiveHint, idempotentHint and openWorldHint values. These are behavior hints, not access controls or permission to spend credits.

  • The 44 analysis tools consume existing AgentSEO credits and may create durable jobs or other charged work, including workflows that only transform supplied data. They are not read-only. Credit consumption is flagged as destructive. The client does not send an idempotency key, so repeating a call can create another charge; these tools declare idempotentHint: false.

  • agentseo_job_status can resume pending work, so it is also not read-only. It polls the same job without an additional debit and declares destructiveHint: false and idempotentHint: true.

  • openWorldHint: false is limited to these supplied-data-only workflows: agentseo_content_keyword_map, agentseo_content_action_plan, agentseo_serp_volatility, agentseo_ai_visibility_prompt_set, agentseo_content_programmatic_template, agentseo_content_cannibalization, agentseo_content_competitor_gap_matrix and agentseo_backlinks_opportunity_finder. They still call AgentSEO and consume credits. The other tools can query or fetch external data, including when pending work is resumed by job polling.

tools/list documents every input property, including nested page, crawl, snapshot, prospect and sample-record fields. Descriptions state purpose, formats, units, accepted enum values, bounds and client defaults where applicable. For example, weekly planning capacity is measured in effort points, result offsets are zero-based row offsets, and a synchronous request can still return a pending job. Poll its returned job ID instead of repeating the charged analysis.

Provider-free contract checks

From this package directory, run:

npm ci --workspaces=false
npm test --workspaces=false

The tests build the package, verify all 45 tools' metadata recursively and compare validation rules/defaults with a pre-metadata schema fixture. They also initialize the real stdio entry point and call tools/list using only dummy credentials, an empty working directory and a preload that blocks network access. Invalid-input rejection is checked without executing any live analysis or provider request.

These checks cover the npm client, independently of the hosted /mcp and /mcp/oauth endpoints. A local build does not publish a new npm version.

Tool catalog

  • agentseo_search

  • agentseo_extract

  • agentseo_analyze_serp

  • agentseo_local_audit

  • agentseo_content_gap

  • agentseo_opportunities_find

  • agentseo_opportunities_brief

  • agentseo_content_refresh_brief

  • agentseo_content_serp_outline

  • agentseo_content_brief

  • agentseo_content_draft_qa

  • agentseo_content_schema_plan

  • agentseo_content_internal_links

  • agentseo_content_title_meta

  • agentseo_content_keyword_map

  • agentseo_content_technical_qa

  • agentseo_content_action_plan

  • agentseo_site_sitemap_audit

  • agentseo_serp_volatility

  • agentseo_page_cro_qa

  • agentseo_ai_visibility_prompt_set

  • agentseo_content_programmatic_template

  • agentseo_content_cannibalization

  • agentseo_content_competitor_gap_matrix

  • agentseo_keyword_ideas_suggest

  • agentseo_keyword_metrics_overview

  • agentseo_domain_ranked_keywords

  • agentseo_domain_relevant_pages

  • agentseo_domain_competitors

  • agentseo_domain_intersection

  • agentseo_domain_traffic_estimate

  • agentseo_backlinks_summary

  • agentseo_backlinks_list

  • agentseo_backlinks_anchors

  • agentseo_backlinks_referring_domains

  • agentseo_backlinks_domain_pages

  • agentseo_backlinks_competitors

  • agentseo_backlinks_new_lost_timeseries

  • agentseo_backlinks_page_intersection

  • agentseo_backlinks_opportunity_finder

  • agentseo_page_intersection

  • agentseo_ai_overview_extract

  • agentseo_local_visibility_track

  • agentseo_rank_track

  • agentseo_job_status

agentseo_ai_overview_extract also accepts an optional target_domain when you want Claude or another MCP client to check whether your site appears in the sampled candidate set for an AI Overview query.

agentseo_content_internal_links requires target_pages; pass 1-50 candidate internal pages from your sitemap, CMS, crawler, Search Console, or agentseo_site_sitemap_audit.

Local Run (Without Claude)

AGENTSEO_API_KEY="sk_live_your_key" npx -y @agentseo/mcp-server

If startup succeeds, you should see:

AgentSEO MCP Server running on stdio

Available Tools

45 tools
agentseo_ai_overview_extractAgentSEO AI Overview ExtractA
Destructive
Inspect

Extract AI Overview insights for a target keyword. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, language, location, +1 more.

agentseo_ai_visibility_prompt_setAgentSEO AI Visibility Prompt SetA
Destructive
Inspect

Build stable AI visibility prompt sets mapped to owned assets, platforms, competitors, citations, and weekly action routing. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), topics (required), category (required), sync, +11 more.

agentseo_analyze_serpAgentSEO Analyze SERPB
Destructive
Inspect

Deep analysis of Search Engine Results Page (SERP) features and competitors. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, device, language, +1 more.

agentseo_backlinks_anchorsAgentSEO Backlinks AnchorsA
Destructive
Inspect

Analyze backlink anchor text groups and classify branded, commercial, generic, URL, risky, broken, or lost anchor patterns. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, offset, +11 more.

agentseo_backlinks_competitorsAgentSEO Backlinks CompetitorsB
Destructive
Inspect

Discover backlink-profile competitors and prioritize overlap, authority, and link-gap research actions. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, offset, +5 more.

agentseo_backlinks_domain_pagesAgentSEO Backlinks Domain PagesB
Destructive
Inspect

Analyze backlink-bearing pages and classify linkable assets, broken backlink pages, lost links, refresh candidates, and quality risks. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, offset, +13 more.

agentseo_backlinks_listAgentSEO Backlinks ListB
Destructive
Inspect

Return a bounded list of actionable backlinks and classify each one for protection, repair, reclaim, quality review, or outreach reference. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), mode, sync, limit, +11 more.

agentseo_backlinks_new_lost_timeseriesAgentSEO Backlinks New/Lost TimeseriesA
Destructive
Inspect

Track new and lost backlinks/referring domains over time and classify link momentum, leakage, and volatility. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, date_to, date_from, +2 more.

agentseo_backlinks_opportunity_finderAgentSEO Backlinks Opportunity FinderA
Destructive
Inspect

Turn supplied backlink prospects, competitor link gaps, and owned assets into prioritized safe outreach, reclaim, repair, and digital PR actions. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), prospects (required), sync, min_priority, +7 more.

agentseo_backlinks_page_intersectionAgentSEO Backlinks Page IntersectionA
Destructive
Inspect

Find source pages that link to competitor targets but not excluded/user targets, then prioritize link-gap outreach and quality review. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: targets (required), sync, limit, offset, +14 more.

agentseo_backlinks_referring_domainsAgentSEO Backlinks Referring DomainsB
Destructive
Inspect

Analyze referring domains and classify authority, lost-domain recovery, broken-link repair, quality review, and outreach patterns. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, offset, +12 more.

agentseo_backlinks_summaryAgentSEO Backlinks SummaryA
Destructive
Inspect

Summarize backlink authority, referring domains, spam risk, broken backlinks, and next SEO actions for a domain, subdomain, or URL. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, rank_scale, dofollow_only, +5 more.

agentseo_content_action_planAgentSEO Content Action PlanA
Destructive
Inspect

Turn supplied SEO opportunities into a capacity-aware content calendar and execution plan. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: items (required), goal, sync, team, +4 more.

agentseo_content_briefAgentSEO Content BriefA
Destructive
Inspect

Turn live SERP intent into a production-ready content brief for writers and coding agents. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, device, target, +7 more.

agentseo_content_cannibalizationAgentSEO Content CannibalizationA
Destructive
Inspect

Detect overlapping SEO pages and recommend safe consolidation, differentiation, canonical, and internal-link fixes. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: pages (required), sync, target, sensitivity, +1 more.

agentseo_content_competitor_gap_matrixAgentSEO Competitor Content Gap MatrixA
Destructive
Inspect

Compare supplied own and competitor pages to find missing topics, weak coverage, format gaps, and buyer-stage gaps. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: competitors (required), sync, target, own_pages, +2 more.

agentseo_content_draft_qaAgentSEO Content Draft QAA
Destructive
Inspect

Validate a draft URL or markdown against live SERP expectations before publishing. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, device, target, +5 more.

agentseo_content_gapAgentSEO Content GapA
Destructive
Inspect

Run content gap analysis for a URL and keyword. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url (required), keyword (required), sync, language, +2 more.

agentseo_content_internal_linksAgentSEO Content Internal LinksA
Destructive
Inspect

Find internal link opportunities from a source page to required supplied target pages. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: sync, target, keyword, source_url, +3 more.

agentseo_content_keyword_mapAgentSEO Content Keyword MapA
Destructive
Inspect

Map supplied keywords to supplied pages and flag missing pages or cannibalization risks. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: pages (required), keywords (required), sync, target, +1 more.

agentseo_content_programmatic_templateAgentSEO Programmatic SEO TemplateA
Destructive
Inspect

Plan safe programmatic SEO templates with uniqueness rules, indexation gates, internal links, schema guidance, and launch QA. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: variables (required), url_pattern (required), data_sources (required), keyword_pattern (required), +13 more.

agentseo_content_refresh_briefAgentSEO Content Refresh BriefA
Destructive
Inspect

Create a refresh brief for an existing URL and keyword. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url (required), keyword (required), sync, language, +2 more.

agentseo_content_schema_planAgentSEO Content Schema PlanA
Destructive
Inspect

Plan JSON-LD schema for a URL or markdown page without a provider call. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url, sync, target, keyword, +3 more.

agentseo_content_serp_outlineAgentSEO SERP OutlineA
Destructive
Inspect

Turn live SERP intent into a writer- and agent-ready page outline. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, device, target, +4 more.

agentseo_content_technical_qaAgentSEO Content Technical QAA
Destructive
Inspect

Run pre-publish SEO QA for metadata, indexability, canonical, headings, schema, links, and media. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url, html, sync, target, +5 more.

agentseo_content_title_metaAgentSEO Content Title MetaA
Destructive
Inspect

Generate SEO title and meta description options for a URL or markdown page. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), url, sync, target, +4 more.

agentseo_domain_competitorsAgentSEO Domain CompetitorsA
Destructive
Inspect

Discover search competitors for a domain and prioritize overlap, traffic gaps, and next analysis actions. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, sort_by, +5 more.

agentseo_domain_intersectionAgentSEO Domain IntersectionA
Destructive
Inspect

Compare two domains to find shared keyword deficits, advantages, and target1-exclusive keyword opportunities. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target1 (required), target2 (required), sync, limit, +6 more.

agentseo_domain_ranked_keywordsAgentSEO Domain Ranked KeywordsA
Destructive
Inspect

Find ranked keywords for a domain, subdomain, or URL and prioritize refresh opportunities. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, sort_by, +6 more.

agentseo_domain_relevant_pagesAgentSEO Domain Relevant PagesA
Destructive
Inspect

Find traffic-carrying pages for a domain and route them into protect, refresh, expand, or recover actions. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, limit, sort_by, +5 more.

agentseo_domain_traffic_estimateAgentSEO Domain Traffic EstimateA
Destructive
Inspect

Compare estimated search traffic across multiple domains, subdomains, or URLs before spending deeper analysis credits. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: targets (required), sync, sort_by, language, +5 more.

agentseo_extractAgentSEO ExtractB
Destructive
Inspect

Extract content from a URL and convert to Markdown. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url (required), include_images.

agentseo_job_statusAgentSEO Job StatusA
Idempotent
Inspect

Get status/result for an existing job. Polling can resume pending work; it does not debit credits again. Repeat polls refer to the same job.

Inputs: job_id (required).

agentseo_keyword_ideas_suggestAgentSEO Keyword Ideas SuggestA
Destructive
Inspect

Expand one seed keyword into prioritized long-tail keyword ideas with search metrics. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), sync, limit, language, +6 more.

agentseo_keyword_metrics_overviewAgentSEO Keyword Metrics OverviewB
Destructive
Inspect

Score a supplied keyword list with search metrics and page-priority guidance. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keywords (required), sync, sort_by, language, +3 more.

agentseo_local_auditAgentSEO Local AuditA
Destructive
Inspect

Audit one Google Maps business listing. Provide its business name and city/state/country; do not pass a website URL or domain. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: location (required), business_name (required), sync, language.

agentseo_local_visibility_trackAgentSEO Local Visibility TrackA
Destructive
Inspect

Track local visibility for a domain across keywords and locations. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: domain (required), keywords (required), locations (required), sync, +1 more.

agentseo_opportunities_briefAgentSEO Opportunity BriefA
Destructive
Inspect

Turn one keyword or page opportunity into an implementation-ready brief. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), keyword (required), sync, language, +5 more.

agentseo_opportunities_findAgentSEO Opportunity FinderA
Destructive
Inspect

Find prioritized SEO opportunities for a domain or URL. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: target (required), sync, language, location, +4 more.

agentseo_page_cro_qaAgentSEO Page CRO QAA
Destructive
Inspect

Audit SEO landing pages for value proposition clarity, CTA strength, trust proof, objection handling, and conversion friction. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url, html, sync, target, +6 more.

agentseo_page_intersectionAgentSEO Page IntersectionA
Destructive
Inspect

Compare ranking pages to find shared page keywords or competitor-page keywords excluded from your pages. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: pages (required), sync, limit, offset, +13 more.

agentseo_rank_trackAgentSEO Rank TrackA
Destructive
Inspect

Queue a rank tracking check for a URL and keyword. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: url (required), keyword (required), sync, location.

agentseo_searchAgentSEO SearchA
Destructive
Inspect

Perform a Google search with optional domain filters. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: query (required), sync, limit, exclude_domains, +1 more.

agentseo_serp_volatilityAgentSEO SERP Volatility MonitorA
Destructive
Inspect

Compare supplied SERP snapshots to detect rank churn, top-domain churn, feature changes, and target visibility movement. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: keyword (required), snapshots (required), sync, device, +4 more.

agentseo_site_sitemap_auditAgentSEO Sitemap AuditA
Destructive
Inspect

Audit sitemap coverage, orphan-page candidates, important URLs, canonical/indexability noise, and internal-link gaps. Uses AgentSEO credits; repeating the call can create new charged work.

Inputs: sync, target, crawl_urls, sitemap_url, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.4/5.0

    Scored across 45 tools

    Disambiguation3/5

    Most tools have descriptive, distinct purposes, but several clusters overlap enough to cause misselection: content_serp_outline vs content_brief, content_gap vs content_competitor_gap_matrix, and the many backlinks_* analysis tools. Descriptions help differentiate them, but an agent must still carefully choose among similar content and backlink diagnostics.

    Naming Consistency4/5

    All tools use the agentseo_ prefix and snake_case, with a generally predictable domain_action or action_noun pattern. There are minor ordering variations such as agentseo_analyze_serp versus agentseo_content_keyword_map, but the naming remains readable and consistent overall.

    Tool Count2/5

    At 45 tools, the surface is very heavy and many tools are granular variants within content, backlink, and domain analysis. While the broad SEO domain can justify many operations, this exceeds a practical well-scoped set and increases selection burden.

    Completeness4/5

    The server covers a wide SEO lifecycle: local audits, keyword research, SERP analysis, content briefs and QA, domain and competitor analysis, backlinks, AI visibility, and rank tracking. A few operational gaps exist, such as job management beyond status polling and broader project/campaign organization, but core workflows are well represented.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • kwrds.ai MCP Server

      mkotsollaris
      A
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol server that enables AI assistants to perform keyword research, SEO analysis, and content planning through natural language queries against kwrds.ai's SEO tools.
      7
      Apache 2.0
    • Serpstat MCP Server

      Serpstat MCP Serverofficial

      SerpstatGlobal
      A
      license
      B
      quality
      D
      maintenance
      Integrates the Serpstat SEO API with the Model Context Protocol to provide AI assistants with comprehensive data for domain analysis, keyword research, and competitor tracking. It enables users to perform complex SEO tasks like backlink analysis and site audits through natural language interfaces.
      65
      114 npm
      5
      MIT

    • SEO Authority MCP

      forgemeshlabs
      A
      license
      A
      quality
      B
      maintenance
      Provides AI agents with typed SEO tools for domain authority, keyword opportunities, competitor gap analysis, content briefs, site audits, and internal links, backed by Common Crawl graph data and optional x402 payment settlement.
      11
      92 npm
      MIT

    • FastestRank MCP

      fastestrank
      A
      license
      Not graded
      quality
      B
      maintenance
      Connects AI agents to live SEO data and hosted tools for site audits, keyword research, competitor analysis, local SEO, and link prospecting, with guided workflows for structured search optimization.
      2
      MIT