# AI My Site

> AI My Site scans a customer's website, measures how visible it is to search
> and to AI assistants (the answers tools like ChatGPT give about it), and
> turns the findings into one ranked action plan with per-item acceptance
> criteria. We give you the qualified answer — exactly what to fix, where, and
> proof the fix landed on the live page. Through this API your coding agent
> (or developer) makes the changes — the API reports and verifies, it never
> edits the site. (A separate done-for-you plan exists for customers who want
> changes made for them.)

App: https://app.goaimysite.com
Marketing site and plans: https://www.goaimysite.com

## Public API (for coding agents)

Base URL: https://app.goaimysite.com/api/v1
Auth: `Authorization: Bearer ams_...` — API keys are created in the app under
Settings → API keys, available on paid plans (Monitor and up). Keys carry
scopes: action_plan:read, items:write, verify:write.

The agent loop: list domains → pull the ranked action plan → implement the
top item in the customer's codebase → POST /verify to confirm the fix is live
→ mark the item complete → repeat.

- [MCP server](https://mcp.goaimysite.com): stateless remote MCP server
  (Streamable HTTP). Five tools mapping 1:1 to the endpoints below
  (list_domains, get_action_plan, get_item, complete_item, verify_items) —
  same scopes and rate limits. Add the URL as a connector and authorise it in
  the browser (OAuth 2.1, no key to copy), or send an ams_ key as the bearer
  token for headless use. The older address
  https://app.goaimysite.com/api/v1/mcp still works with an API key
- [Protected-resource metadata](https://mcp.goaimysite.com/.well-known/oauth-protected-resource):
  RFC 9728 document naming the authorization server for the MCP endpoint —
  clients are pointed here by the 401 challenge and register themselves
- [OpenAPI 3.1 spec](https://app.goaimysite.com/api/v1/openapi.json): full
  machine-readable description of every endpoint, schema and error code
- [Plugin manifest](https://app.goaimysite.com/.well-known/ai-plugin.json):
  bearer-auth manifest pointing at the OpenAPI spec
- [Claude Skill bundle](https://app.goaimysite.com/aimysite-skill.zip):
  SKILL.md teaching an agent the full fix-verify loop, with exact curl calls
  and error recovery
- [Developer quickstart](https://app.goaimysite.com/developers): how a human
  sets up API access for their coding agent

## Notes for agents

- Errors use the envelope { "error": { "code", "message", "details"? } }.
  401/403 are permanent (bad key / missing scope / no paid plan) — do not
  retry them.
- Rate limits per key: 60 reads/min, 10 writes/min (429 carries Retry-After).
- Always call GET /api/v1/domains first and use the returned domain id
  (e.g. dom_12) — never pass URLs, never guess ids.
- API access requires an AI My Site account on a paid plan. Sign up at
  https://www.goaimysite.com/pricing