API & MCP documentation

Build a monthly client report without opening the dashboard. Then let your brand-trained assistant polish an article — the same way you would in the editor.

Sign in to connect an assistant. A connection can only see the websites on that account.

What you can do

  1. List the websites on your account.
  2. List articles published in a date range, with the target search term and word count.
  3. List backlinks you acquired, including industry vs local.
  4. Pull a period summary for a monthly report.
  5. Edit an article title and body, or replace the featured image.

Authentication

For Claude, Cursor, or ChatGPT: paste the MCP address. Sign in when AutoSEO opens. Click Allow. No API key.

https://mcp.getautoseo.com/mcp

For your own code, create a key on Connect Site and send it on every request:

Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY

Limit: 60 requests per minute. Article edits: 200 per day.

Read endpoints

  • GET /api/v1/sites — your websites
  • GET /api/v1/sites/{id}/articles?from=&to=&status= — id, title, url, status, published_at, target keyword, word count, featured image
  • GET /api/v1/articles/{id} — full HTML body. Protected links include data-autoseo-protected.
  • GET /api/v1/sites/{id}/backlinks?from=&to= — date acquired, source domain, source url, target url, anchor text, anchor type, category (industry / local)
  • GET /api/v1/sites/{id}/stats?period= — articles and backlinks for this_month, last_month, last_30_days, or YYYY-MM

Lists are paginated. Use page and per_page (max 100).

Write endpoints

Writes only change articles on your own sites. Settings, search terms, and backlinks stay off limits.

  • PUT /api/v1/articles/{id} — JSON: title, body (HTML), optional reason. Same sanitising as the editor. No scripts or raw iframes.
  • POST /api/v1/articles/{id}/featured-image — multipart image, or JSON { "url": "https://..." }.
Do not remove or rewrite inserted backlink anchors or internal links. Those blocks are marked in the HTML. An edit that strips them is rejected so the backlink network stays intact.

MCP for agents

Paste the hosted address in Claude, Cursor, or ChatGPT. The assistant opens AutoSEO. You sign in and click Allow.

https://mcp.getautoseo.com/mcp

Tools: list_sites, list_articles, get_article, list_backlinks, get_stats, update_article, replace_featured_image.

Learning log

Every API and MCP call is stored. Every article change is stored as a revision (API, MCP, editor, or rewrite). You can open the activity log and restore an earlier version from the article page.

OpenAPI

Machine-readable spec:

https://blog.drglennmacfarlane.com/api/v1/openapi.json