Claude Code + agentsgym over MCP

Reading a marketing dashboard is a task you keep postponing. Handing the numbers to the agent that already edits your site is not. This page is the setup, and what to ask for once it is wired.

Setup

1. Sign in and copy your personal API key (agk_…) from the settings page.
2. Add the server to Claude Code:

claude mcp add --transport http agentsgym https://api.agentsgym.com/mcp \
  --header "Authorization: Bearer agk_your_key_here"

3. Confirm the tools are live:

claude mcp list

You should see agentsgym with projects_list, project_get, project_badge_url, score_url, scans_list and rubric_list.

What the agent can do with it

Tool	Returns	Typical use
projects_list	Your startups + latest Domain Rating	“Did anything move this week?”
project_get	Authority history, daily pageviews/visitors, top referrers, recent scans	The weekly review, in one call
score_url	Overall 0–10, per-dimension scores, severity-ranked action items	Score a page before and after an edit
scans_list	Past scans for a URL, newest first	Prove the fix moved the score
rubric_list	The 8 weighted AEO dimensions	Let the agent reason about why a dimension is low
project_badge_url	Share URL, badge SVG URL, tracking snippet	Drop the badge into a README

The loop the server tells the agent to run: projects_list → project_get → fix the highest-severity action items → score_url again → watch referring_domains and pageviews over the following days.

Prompts that actually do work

• “Read agentsgym’s skill resource, then score every page under /alternatives and fix the two lowest-scoring dimensions on the worst page.”
• “Pull project_get for my startup and tell me which referrer sent the most pageviews yesterday that I have never seen before.”
• “My Domain Rating has not moved in three weeks. Show referring_domains over that window and tell me whether the problem is links or lag.”

Honest limits, so the agent does not overclaim

• Domain Rating is not Ahrefs’ DR. It is 0–100, computed from DataForSEO’s backlink metric. It moves slowly; referring_domains is the number that reacts within days of a new link.
• AEO scores are on-page and deterministic. They measure how citable a page is — not whether ChatGPT, Claude or Google’s AI Overview has actually cited it.
• One authority reading per project per UTC day. Asking twice does not produce a second data point.
• Failed checks stay empty. A provider error records the error; it never writes a 0 to fill the gap. If your agent sees a hole in the series, that hole is real.

Anonymous use, no account

score_url, scans_list and rubric_list work with a service token, so you can score any URL without an account — useful when you want the agent to check a competitor’s page structure. The account tools stay invisible to that token.

Once it is wired, the natural next step is connecting Search Console so the same agent can see queries alongside authority. If you are here because a paid SEO seat felt like too much tool for one product, read Ahrefs alternatives.