{"_id":"@agentseo/mcp-server","_rev":"4-0a0ab59d0045c7858b0a5c434cccf2dd","name":"@agentseo/mcp-server","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@agentseo/mcp-server","version":"0.1.0","license":"MIT","_id":"@agentseo/mcp-server@0.1.0","maintainers":[{"name":"danielmartin16","email":"wildsummitgear@gmail.com"}],"bin":{"agentseo-mcp-server":"dist/index.js"},"dist":{"shasum":"26bbc63a1bbebf545ba84e3cf89034e0dd1998ba","tarball":"https://registry.npmjs.org/@agentseo/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":6,"integrity":"sha512-Y98B77k+bvDvoIDnWScOHWmOloQ2oE/JynVBhN3VPW9GpCc0+4LgouzGA0kcYR42PZiyJLOQ9agHSYJiU6hARg==","signatures":[{"sig":"MEQCID8V4BxiKUg2dalKfusFklgNpbDQbfOsYCz/zNnKzVc3AiB2sBrwORq60+k7q2min6GIdX3eN/afqMtYlg///6X3SQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26339},"type":"module","gitHead":"7900e526b3d0fb6ca5645278de6f2109921110f5","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"danielmartin16","email":"wildsummitgear@gmail.com"},"_npmVersion":"11.6.2","description":"The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop and other MCP clients.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.23.8","axios":"^1.7.7","dotenv":"^16.4.5","@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.8.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1771273731285_0.6932392534702871","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentseo/mcp-server","version":"0.1.1","license":"MIT","_id":"@agentseo/mcp-server@0.1.1","maintainers":[{"name":"danielmartin16","email":"wildsummitgear@gmail.com"}],"bin":{"agentseo-mcp-server":"dist/index.js"},"dist":{"shasum":"79daa52a8e739637b5e4bc868cafcc01aeff39e3","tarball":"https://registry.npmjs.org/@agentseo/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":6,"integrity":"sha512-vR2iX/KPgOD+LiOHFrinTHf/HGIa3h71ViBrTLDiP+tXXqNEtjX5MCLVMwSdfUlTEUMYfNsxGUXoYAGLfH9e4Q==","signatures":[{"sig":"MEQCIER96HtLn8Pv10P9XzHNhpzQjmn+q3jjtRjmCuCnRocsAiBM8YnBP9S0TMaSB0y0bdYX3Mxkdq1aIWv2yCiEA2ORrg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30385},"type":"module","gitHead":"be9dd0c9f75ba9955b9dcd9736ca1a9976065629","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"danielmartin16","email":"wildsummitgear@gmail.com"},"_npmVersion":"11.6.2","description":"The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.23.8","axios":"^1.7.7","dotenv":"^16.4.5","@modelcontextprotocol/sdk":"latest"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.8.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1772281054605_0.6717806287678156","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentseo/mcp-server","version":"0.1.2","license":"MIT","_id":"@agentseo/mcp-server@0.1.2","maintainers":[{"name":"danielmartin16","email":"wildsummitgear@gmail.com"}],"homepage":"https://github.com/AgentSEO-dev/agentseo-clients#readme","bugs":{"url":"https://github.com/AgentSEO-dev/agentseo-clients/issues"},"bin":{"agentseo-mcp-server":"dist/index.js"},"dist":{"shasum":"cd034c1b12db57128fad914a4a26eecff3ee3b06","tarball":"https://registry.npmjs.org/@agentseo/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":8,"integrity":"sha512-jJHw9ZSpU9dPuwYk+wT4AIzbl5x6e9IU0c6qToOeLeyGtuZ4j1sl8SR7HL2hNh3kzduRbG1wqs+zXxdGHjvziw==","signatures":[{"sig":"MEUCIQDHrbJeG4XIU2yYfMNdq/JQNWGcSYzAubmC8bcDzk7VbAIgfxqG6zi2NIXJ9QO0DhUVNjWHB4XvBeeNXVOrwXr3EmU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":163075},"type":"module","gitHead":"ea0834f2d7186e054bcf8e078401adb0cebf55be","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"danielmartin16","email":"wildsummitgear@gmail.com"},"repository":{"url":"git+https://github.com/AgentSEO-dev/agentseo-clients.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.23.8","axios":"^1.7.7","dotenv":"^16.4.5","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.8.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1784526620982_0.4170269290765223","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentseo/mcp-server","mcpName":"dev.agentseo.www/agentseo-mcp","version":"0.1.3","type":"module","license":"MIT","bin":{"agentseo-mcp-server":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/AgentSEO-dev/agentseo-clients.git","directory":"packages/mcp-server"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","zod":"^3.23.8","axios":"^1.7.7","dotenv":"^16.4.5"},"devDependencies":{"typescript":"^5.6.3","@types/node":"^22.8.1"},"gitHead":"241b66c5534b1a85b54bfa619d1d24eaf1b833d9","_id":"@agentseo/mcp-server@0.1.3","description":"The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.","bugs":{"url":"https://github.com/AgentSEO-dev/agentseo-clients/issues"},"homepage":"https://github.com/AgentSEO-dev/agentseo-clients#readme","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-iz8oBFHGiHbUoAUwZFjm8fsWMTCgpuEA74c3h0duZqx+rRhEeKqQVIw9vsvH+qVWZEIimw9hdIinhJJQBTCQxw==","shasum":"aba01e9031dbad56aad9fa6d8d909dbd23e6b94a","tarball":"https://registry.npmjs.org/@agentseo/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":9,"unpackedSize":164264,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDXlOFXjGW+x4IbMJZ8vaE4i+ouIB/2QeGIg5Ad3h2gZwIgZSjD3brDpTjNcjixWOOqbDACnlxPra5IFAlZsYD/MPI="}]},"_npmUser":{"name":"danielmartin16","email":"wildsummitgear@gmail.com"},"directories":{},"maintainers":[{"name":"danielmartin16","email":"wildsummitgear@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.3_1784556157307_0.6170066464303914"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-16T20:28:51.176Z","modified":"2026-07-20T14:02:37.689Z","0.1.0":"2026-02-16T20:28:51.437Z","0.1.1":"2026-02-28T12:17:34.765Z","0.1.2":"2026-07-20T05:50:21.116Z","0.1.3":"2026-07-20T14:02:37.437Z"},"bugs":{"url":"https://github.com/AgentSEO-dev/agentseo-clients/issues"},"license":"MIT","homepage":"https://github.com/AgentSEO-dev/agentseo-clients#readme","repository":{"type":"git","url":"git+https://github.com/AgentSEO-dev/agentseo-clients.git","directory":"packages/mcp-server"},"description":"The official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.","maintainers":[{"name":"danielmartin16","email":"wildsummitgear@gmail.com"}],"readme":"# @agentseo/mcp-server\n\nThe official Model Context Protocol (MCP) server for AgentSEO. Exposes SEO tools to Claude Desktop, Cursor, and other MCP clients.\n\n## Hosted remote MCP\n\nAgentSEO also exposes a hosted remote MCP endpoint:\n\n`https://www.agentseo.dev/mcp`\n\nUse a server-side API key with no allowed domains.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http agentseo https://www.agentseo.dev/mcp \\\n  --header \"Authorization: Bearer sk_live_your_key\" \\\n  --header \"x-project-id: client-alpha\" \\\n  --header \"x-workflow-id: nightly-refresh\"\n```\n\n### Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"agentseo\": {\n      \"url\": \"https://www.agentseo.dev/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk_live_your_key\",\n        \"x-project-id\": \"client-alpha\",\n        \"x-workflow-id\": \"nightly-refresh\"\n      }\n    }\n  }\n}\n```\n\n## Quickstart (Claude Desktop / Cursor)\n\n### 1. Set your API key\n\n```bash\nexport AGENTSEO_API_KEY=\"sk_live_your_key\"\n```\n\n### 2. Add AgentSEO MCP server to your MCP config\n\nFor Claude Desktop, add this to `claude_desktop_config.json`.\nFor Cursor, add the same block in MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentseo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agentseo/mcp-server\"],\n      \"env\": {\n        \"AGENTSEO_API_KEY\": \"sk_live_your_key\",\n        \"AGENTSEO_API_URL\": \"https://www.agentseo.dev/api/v1\",\n        \"AGENTSEO_PROJECT_ID\": \"client-alpha\",\n        \"AGENTSEO_WORKFLOW_ID\": \"nightly-refresh\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart your MCP client\n\nAfter restart, ask Claude or Cursor:\n\n`Run agentseo_local_audit for example.com in New York, NY`\n\n## Environment Variables\n\n- `AGENTSEO_API_KEY` (required): Your workspace API key.\n- `AGENTSEO_API_URL` (optional): Defaults to `https://www.agentseo.dev/api/v1`.\n  - For local development use `http://localhost:3000/api/v1`.\n- `AGENTSEO_PROJECT_ID` (optional): Default project attribution for all tool calls.\n- `AGENTSEO_WORKFLOW_ID` (optional): Default workflow attribution for all tool calls.\n\n## Available Tools\n\n- `agentseo_search`\n- `agentseo_extract`\n- `agentseo_analyze_serp`\n- `agentseo_local_audit`\n- `agentseo_content_gap`\n- `agentseo_opportunities_find`\n- `agentseo_opportunities_brief`\n- `agentseo_content_refresh_brief`\n- `agentseo_content_serp_outline`\n- `agentseo_content_brief`\n- `agentseo_content_draft_qa`\n- `agentseo_content_schema_plan`\n- `agentseo_content_internal_links`\n- `agentseo_content_title_meta`\n- `agentseo_content_keyword_map`\n- `agentseo_content_technical_qa`\n- `agentseo_content_action_plan`\n- `agentseo_site_sitemap_audit`\n- `agentseo_serp_volatility`\n- `agentseo_page_cro_qa`\n- `agentseo_ai_visibility_prompt_set`\n- `agentseo_content_programmatic_template`\n- `agentseo_content_cannibalization`\n- `agentseo_content_competitor_gap_matrix`\n- `agentseo_keyword_ideas_suggest`\n- `agentseo_keyword_metrics_overview`\n- `agentseo_domain_ranked_keywords`\n- `agentseo_domain_relevant_pages`\n- `agentseo_domain_competitors`\n- `agentseo_domain_intersection`\n- `agentseo_domain_traffic_estimate`\n- `agentseo_backlinks_summary`\n- `agentseo_backlinks_list`\n- `agentseo_backlinks_anchors`\n- `agentseo_backlinks_referring_domains`\n- `agentseo_backlinks_domain_pages`\n- `agentseo_backlinks_competitors`\n- `agentseo_backlinks_new_lost_timeseries`\n- `agentseo_backlinks_page_intersection`\n- `agentseo_backlinks_opportunity_finder`\n- `agentseo_page_intersection`\n- `agentseo_ai_overview_extract`\n- `agentseo_local_visibility_track`\n- `agentseo_rank_track`\n- `agentseo_job_status`\n\n`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.\n\n`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`.\n\n## Local Run (Without Claude)\n\n```bash\nAGENTSEO_API_KEY=\"sk_live_your_key\" npx -y @agentseo/mcp-server\n```\n\nIf startup succeeds, you should see:\n\n`AgentSEO MCP Server running on stdio`\n","readmeFilename":"README.md"}