GeoCopy MCP server
Connect Cursor, Claude, ChatGPT, Windsurf, Zed, or VS Code to generate GEO-optimized articles with the same API keys and billing as REST v2.
Endpoint & authentication
Streamable HTTP MCP at /api/mcp — Bearer sk_live_* keys from the Developer hub.
https://app.geocopy.io/api/mcpGeneration is async: call geocopy_create_article, then geocopy_wait_for_articleor poll with geocopy_get_article. Same rate limits as REST API v2.
Connect your AI tool
Cursor
Config file: .cursor/mcp.json (project) or Cursor Settings → MCP
- Create an API key in the Developer hub (Portal → API keys or /developer).
- Add the JSON below to .cursor/mcp.json in your project root (or paste in Cursor Settings → MCP).
- Replace the placeholder key with your sk_live_* key.
- Restart Cursor or reload MCP servers. GeoCopy tools appear in the agent tool list.
mcp.json
{
"mcpServers": {
"geocopy": {
"url": "https://app.geocopy.io/api/mcp",
"headers": {
"Authorization": "Bearer sk_live_YOUR_KEY"
}
}
}
}MCP tools (v1)
Public API v2 operations exposed as MCP tools for agents and chat clients.
| Tool | Description | Parameters |
|---|---|---|
| geocopy_get_account | Credits, quota, concurrency limits, and billing hints. | none |
| geocopy_list_articles | List articles with optional status/channel filters and pagination. | status, creation_channel, limit, offset |
| geocopy_get_article | Fetch one article by ID (status, metadata, markdown/html content). | id (uuid) |
| geocopy_create_article | Start async article generation; returns queued job with article id. | primary_keyword, secondary_keywords, intent_category, search_intent, topic, target_word_count, length_preference, reader_voice, brand_voice, first_person_stance |
| geocopy_wait_for_article | Poll until terminal status or timeout (default 120s). Use when you want the model to block instead of manual polling. | id, timeout_seconds, poll_interval_seconds |