API

Authentication

Send your key as x-api-key: mg_live_… or Authorization: Bearer mg_live_…. Keys are shown once at creation.

POST /api/v1/run

Run one tool. Body: { tool, input }.

curl -s https://mars.cx/api/v1/run \
  -H "Authorization: Bearer mg_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tool":"faq-schema-generator","input":{"items":[{"q":"What is MarsGeo?","a":"Free SEO tools"}]}}'

Response: { ok, tool, output, contentType }

POST /api/v1/bulk

Run up to 100 inputs. Body: { tool, inputs: [...] }.

curl -s https://mars.cx/api/v1/bulk \
  -H "x-api-key: mg_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tool":"meta-description-generator","inputs":[{"text":"First page"},{"text":"Second page"}]}'

Supported tools

• faq-schema-generator
• article-schema-generator
• product-schema-generator
• how-to-schema-generator
• breadcrumb-schema-generator
• organization-schema-generator
• robots-txt-generator
• sitemap-generator
• hreflang-generator
• meta-description-generator
• open-graph-generator
• serp-snippet-preview
• keyword-density-analyzer
• schema-validator
• meta-tag-extractor
• heading-extractor
• json-ld-extractor

MCP server

Use these tools from AI agents via the Model Context Protocol. A hosted endpoint is live at https://mars.cx/api/mcp — point any MCP client at it, no install needed.

{
  "mcpServers": { "marsgeo": { "type": "http", "url": "https://mars.cx/api/mcp" } }
}

Or run the local stdio server from mcp/ in the repository.

cd mcp && npm install
MARSGEO_API_KEY=mg_live_... node server.mjs

It exposes generate_faq_schema, generate_sitemap, generate_robots_txt and a generic run_marsgeo_tool. See /mcp.