SEO MCP tools: all 49, with their inputs

The tracked websites, with keyword counts and average position.

When

First, to get the project ids most other tools need.

Cost

Not metered.

It takes no inputs.

{
  "projects": [
    {
      "id": 1,
      "domain": "alpinerun.example",
      "name": "Alpine Run",
      "location": "New York, New York, United States",
      "language": "en",
      "device": "desktop",
      "keywords": 18,
      "has_icon": false,
      "average_position": 8.5
    }
  ]
}

Finds a country or city and returns its location code, up to 10 matches.

When

Before create_project or update_project.

Cost

Not metered.

{
  "locations": [
    {
      "location_code": 1023191,
      "name": "New York, New York, United States",
      "type": "City"
    }
  ]
}

The Google languages a project can use, with their codes.

When

Before create_project or update_project, to set a language.

Cost

Not metered.

It takes no inputs.

{
  "languages": [
    {
      "code": "en",
      "name": "English"
    },
    {
      "code": "es",
      "name": "Spanish"
    }
  ]
}

The plan, its limits and what is left: keywords, projects and refresh checks this month and this hour.

When

Before refreshing many keywords.

Cost

Not metered.

It takes no inputs.

{
  "plan": "starter",
  "keywords": {
    "used": 34,
    "limit": 200
  },
  "projects": {
    "used": 4,
    "limit": 10
  },
  "refresh_checks": {
    "left_this_month": 1000,
    "monthly_limit": 1000,
    "left_this_hour": 500,
    "hourly_limit": 500
  }
}

A project's headline numbers: average position and the one before it, how many keywords sit in the top 3, 10 and 30, and today's biggest winners and losers. The average covers only the keywords in the top 30, which buckets.ranked counts. A loser with a null position left the top 30 from dropped_from.

When

For the state of a project at a glance.

Cost

Not metered.

{
  "project": {
    "id": 1,
    "domain": "alpinerun.example"
  },
  "average_position": 8.47,
  "previous_average_position": 8.35,
  "buckets": {
    "top3": 3,
    "top10": 11,
    "top30": 17,
    "ranked": 17,
    "not_ranked": 1,
    "pending": 0,
    "total": 18
  },
  "winners": [
    {
      "id": 6,
      "term": "trail running poles",
      "position": 3,
      "change": 1
    }
  ],
  "losers": [
    {
      "id": 1,
      "term": "trail running shoes",
      "position": 7,
      "change": -3,
      "dropped_from": null
    }
  ]
}

Current positions for a project's keywords, with previous and best position, monthly searches and CPC when known. Each keyword also says whether it is starred, whether Google shows an AI Overview and whether you are cited in it. A position of null means not in the top 30, or not checked yet when last_checked is also null.

When

To read the current state, or to get keyword ids. Filter by list, search words, stars, position range or only what moved at the last check.

Cost

Not metered.

{
  "keywords": [
    {
      "id": 3,
      "keyword": "best running socks",
      "position": 1,
      "previous_position": 1,
      "best_position": 1,
      "monthly_searches": 4400,
      "cpc_usd": 0.64,
      "url": "https://alpinerun.example/guides/best-running-socks",
      "lists": [
        "socks"
      ],
      "starred": false,
      "ai_overview": true,
      "ai_cited": true,
      "last_checked": "2026-11-07"
    }
  ],
  "page": 1,
  "pages": 18,
  "total": 18
}

One keyword's daily record: date, position and ranking page, up to 365 days back. A position of null means not in the top 30.

When

To quote a past position, or to see how a keyword got where it is.

Cost

Not metered.

{
  "keyword": "trail running shoes",
  "history": [
    {
      "date": "2026-11-06",
      "position": 4,
      "url": "https://alpinerun.example/shoes/trail"
    },
    {
      "date": "2026-11-07",
      "position": 7,
      "url": "https://alpinerun.example/shoes/trail"
    }
  ]
}

The biggest winners and losers of a project over 1, 7 or 30 days, up to 20 on each side. Change is places gained, so negative means lost. A keyword that left the top 30 is a loser with a null position and dropped_from saying where it was. One that entered the top 30 has no earlier number to compare, so it is not listed.

When

When the person asks what moved.

Cost

Not metered.

{
  "period": "7d",
  "winners": [
    {
      "keyword": "running shoes for wide feet",
      "position": 6,
      "change": 2
    }
  ],
  "losers": [
    {
      "keyword": "trail running shoes",
      "position": 7,
      "change": -3
    },
    {
      "keyword": "ultramarathon training plan",
      "position": null,
      "change": null,
      "dropped_from": 28
    }
  ]
}

Compares a keyword on two dates: its position, the stored top results and which sites entered or dropped out. It returns a difference, never a cause. By default it compares the latest check with the last check at a different position. Top results are kept 90 days; older dates give the position only.

When

When the person asks what changed around a keyword.

Cost

Not metered.

{
  "keyword": "trail running shoes",
  "summary": "\"trail running shoes\" moved down 3 places: 4 on 2026-11-06 to 7 on 2026-11-07.",
  "change": -3,
  "from": {
    "date": "2026-11-06",
    "position": 4,
    "url": "https://alpinerun.example/shoes/trail",
    "top": [
      {
        "position": 1,
        "domain": "ridgeoutfitters.example",
        "title": "Trail running shoes | ridgeoutfitters.example",
        "url": "https://ridgeoutfitters.example/trail-running-shoes"
      }
    ]
  },
  "to": {
    "date": "2026-11-07",
    "position": 7,
    "url": "https://alpinerun.example/shoes/trail",
    "top": [
      {
        "position": 1,
        "domain": "ridgeoutfitters.example",
        "title": "Trail running shoes | ridgeoutfitters.example",
        "url": "https://ridgeoutfitters.example/trail-running-shoes"
      }
    ]
  },
  "entered": [
    "gearlab-reviews.example"
  ],
  "dropped": [
    "fleetfootmag.example"
  ],
  "note": null
}

Starts tracking a website in one location, language and device. It starts with one alert rule, moved_down 5, which update_alert or delete_alert can change.

When

When the person wants a new site tracked. Call search_locations first.

Cost

Counts against the plan's project limit. Needs a plan or a running trial.

{
  "project": {
    "id": 5,
    "domain": "summitbikes.example",
    "device": "mobile",
    "location_code": 1023191
  }
}

Changes a project's name, domain, location, language or device. Changing location, language or device starts a new history for every keyword.

When

When the person changes a project. Confirm a new location, language or device first. The tool says so.

Cost

Needs a plan or a running trial.

{
  "project": {
    "id": 5,
    "name": "Summit Bikes",
    "domain": "summitbikes.example",
    "location_code": 1023191,
    "language": "en",
    "device": "mobile"
  }
}

Gives a project its own icon, from a public image address or base64: PNG, JPEG, WebP, GIF or ICO, up to 2 MB.

When

When the person wants a project's tile to show its own icon.

Cost

Needs a plan or a running trial.

{
  "project_id": 5,
  "icon": {
    "format": "png",
    "size_bytes": 237
  }
}

Removes a project's icon, so its tile goes back to the first letter of the domain.

When

When the person wants the icon gone.

Cost

Not metered.

{
  "project_id": 5,
  "icon": null
}

Deletes a project with all its keywords, history, competitors, alerts and report settings. It cannot be undone, and it needs the project's exact domain as confirm_domain.

When

Only after confirming with the person. The tool says so.

Cost

Not metered.

{
  "deleted": {
    "id": 5,
    "domain": "summitbikes.example"
  }
}

Starts tracking keywords in a project, up to 500 in a call, optionally in lists. Duplicates are skipped. Read the first positions with get_rankings once the first check is back.

When

When the person gives keywords to track.

Cost

Counts against the plan's keyword limit. Needs a plan or a running trial.

{
  "added": 4,
  "skipped": 0,
  "queued": 4
}

Checks keywords now, by ids or by list, instead of waiting for the next daily check. Most fresh positions arrive within two minutes; a late one can take up to 6 hours, and a check that fails is given back. A keyword is fresh once its last_checked in get_rankings changes.

When

After a page changes, or when the person asks for a new position today.

Cost

One check per keyword within the monthly and hourly limits; a call past either is rejected whole. A search checked in the last hour reuses free. Needs a plan or a running trial.

{
  "checks_used": 0,
  "reused_free": 2,
  "checks_left_this_month": 1000,
  "checks_left_this_hour": 500,
  "note": "Most fresh positions arrive within two minutes; a late one can take up to 6 hours, and a check that fails is given back. A keyword is fresh once its last_checked in get_rankings changes."
}

Changes a keyword's wording. Google is then searched for the new wording, so its position starts again and the old history no longer shows.

When

Only after confirming with the person. The tool says so.

Cost

Needs a plan or a running trial.

{
  "keyword": {
    "id": 38,
    "keyword": "gravel bikes",
    "position": null
  }
}

Marks keywords as starred, or takes the star off, up to 500 ids.

When

To keep the keywords that matter easy to filter in get_rankings.

Cost

Not metered.

{
  "changed": 2
}

Stops tracking keywords and deletes their history. It needs the exact ids, 100 at most, and there is no way to remove all.

When

Only after confirming with the person. The tool says so.

Cost

Not metered. Frees keyword allowance.

{
  "removed": 1
}

A project's keyword lists, with how many keywords each holds.

When

Before filtering or refreshing by list.

Cost

Not metered.

{
  "lists": [
    {
      "id": 3,
      "name": "gear",
      "keywords": 7
    },
    {
      "id": 4,
      "name": "guides",
      "keywords": 3
    }
  ]
}

Creates an empty keyword list in a project.

When

Before sorting keywords into a new list.

Cost

Not metered.

{
  "list": {
    "id": 11,
    "name": "autumn"
  }
}

Renames a keyword list. Its keywords stay in it.

When

When the person renames a list.

Cost

Not metered.

{
  "list": {
    "id": 11,
    "name": "autumn sale"
  }
}

Puts keywords in a list, up to 500 ids. The list is created if it does not exist.

When

To group keywords for filtering, refreshing or alerts.

Cost

Not metered.

{
  "keywords_affected": 2
}

Takes keywords out of a list, up to 500 ids. The keywords stay tracked.

When

When keywords no longer belong in a list.

Cost

Not metered.

{
  "keywords_affected": 1
}

Deletes a keyword list. The keywords in it are not deleted.

When

Only after confirming with the person. The tool says so.

Cost

Not metered.

{
  "deleted_list": "autumn sale",
  "keywords_deleted": 0
}

The competitor websites a project watches, with their ids and how many the plan allows.

When

Before adding or removing a competitor.

Cost

Not metered.

{
  "competitors": [
    {
      "id": 2,
      "domain": "runnersdepot.example"
    },
    {
      "id": 3,
      "domain": "summitgear.example"
    },
    {
      "id": 1,
      "domain": "trailhouse.example"
    }
  ],
  "limit_per_project": 3
}

Watches a competitor's website in a project. Its positions come from the daily checks already run for your keywords.

When

When the person names a rival to watch.

Cost

Uses no refresh checks. Counts against the plan's competitors per project. Needs a plan or a running trial.

{
  "competitor": {
    "id": 9,
    "domain": "rivalbikes.example"
  }
}

Keyword by keyword: your position beside each competitor's latest position, and whether Google shows an AI Overview and cites you in it. A position of null means not in the top 30.

When

When the person asks who ranks above them.

Cost

Not metered.

{
  "keywords": [
    {
      "id": 3,
      "keyword": "best running socks",
      "you": 1,
      "competitors": {
        "runnersdepot.example": 4,
        "summitgear.example": 12,
        "trailhouse.example": 3
      },
      "ai_overview": true,
      "ai_cited": true
    }
  ],
  "page": 1,
  "pages": 18,
  "total": 18
}

Share of visibility for you and each competitor, per day and now, over 7 to 90 days. It is an estimate from typical click rates by position, and it measures no visits.

When

When the person asks how they compare overall.

Cost

Not metered.

{
  "domains": [
    {
      "domain": "alpinerun.example",
      "is_you": true,
      "competitor_id": null,
      "score": 15.5,
      "change": 0
    },
    {
      "domain": "runnersdepot.example",
      "is_you": false,
      "competitor_id": 2,
      "score": 14.8,
      "change": -0.8
    }
  ],
  "series": [
    {
      "date": "2026-11-07",
      "scores": {
        "alpinerun.example": 15.5,
        "runnersdepot.example": 14.8
      }
    }
  ]
}

Stops watching a competitor and deletes its stored positions.

When

Only after confirming with the person. The tool says so.

Cost

Not metered. Frees a competitor place.

{
  "removed": {
    "id": 9,
    "domain": "rivalbikes.example"
  }
}

Sets a rule. When a keyword crosses it, the account owner gets an email summary, at most one a day per project; a move checked after that day's summary goes in the next one. A rule watches the whole project or one list. moved_up sees a keyword in the top 30 at both checks. moved_down also fires, whatever the threshold, for one that leaves the top 30. Asking for a rule the project already has returns that rule, switched on, with created false.

When

When the person wants to hear about a drop or a gain.

Cost

Not metered.

{
  "alert": {
    "id": 7,
    "rule": "Moved down 3+ places",
    "list": "Spring"
  },
  "created": true
}

A project's alert rules, with their ids and whether each is on.

When

Before adding, changing or deleting a rule.

Cost

Not metered.

{
  "alerts": [
    {
      "id": 1,
      "type": "moved_down",
      "threshold": 3,
      "enabled": true,
      "rule": "Moved down 3+ places",
      "list": null
    },
    {
      "id": 2,
      "type": "entered_top3",
      "threshold": null,
      "enabled": true,
      "rule": "Entered the top 3",
      "list": null
    }
  ]
}

Turns an alert rule on or off, or changes how many places it watches for.

When

When the person wants a rule paused or changed.

Cost

Not metered.

{
  "alert": {
    "id": 7,
    "type": "moved_down",
    "threshold": 5,
    "enabled": true,
    "rule": "Moved down 5+ places",
    "list": "spring"
  }
}

The alerts a project has fired, newest first: date, keyword, the rule and the move, 50 to a page. A position of null means not in the top 30.

When

When the person asks what fired.

Cost

Not metered.

{
  "events": [
    {
      "date": "2026-11-07T06:00:00+00:00",
      "keyword": "trail running shoes",
      "keyword_id": 1,
      "rule": "Moved down 2+ places",
      "from": 4,
      "to": 7
    }
  ],
  "page": 1,
  "pages": 1,
  "total": 9
}

Deletes an alert rule.

When

Only after confirming with the person, or turn it off with update_alert instead. The tool says so.

Cost

Not metered.

{
  "deleted": 7
}

The Slack channels and webhooks that receive a project's daily alert summary, with their status. The full addresses stay hidden, because they can hold a secret.

When

Before adding or testing a channel.

Cost

Not metered.

{
  "channels": [
    {
      "id": 1,
      "type": "slack",
      "host": "hooks.slack.com",
      "status": "active",
      "last_error": null,
      "last_success_at": "2026-11-07T09:00:00+00:00"
    },
    {
      "id": 2,
      "type": "webhook",
      "host": "hooks.larkfield.example",
      "status": "active",
      "last_error": null,
      "last_success_at": "2026-11-07T09:00:00+00:00"
    }
  ]
}

Sends a project's daily alert summary to a Slack incoming webhook or to any public https address. A webhook's signing secret is shown once, in the reply.

When

When the person wants alerts in Slack or in their own system.

Cost

Needs a plan or a running trial.

{
  "channel": {
    "id": 3,
    "type": "slack",
    "host": "hooks.slack.com",
    "status": "active",
    "last_error": null,
    "last_success_at": null
  }
}

Sends a test message to a Slack channel or webhook and says whether it arrived.

When

After adding a channel.

Cost

Needs a plan or a running trial.

{
  "ok": true,
  "error": null
}

Stops sending a project's alerts to a Slack channel or webhook.

When

Only after confirming with the person. The tool says so.

Cost

Not metered.

{
  "deleted": 3
}

Makes the branded PDF report of a project over 7 or 30 days, 30 by default: overview, winners and losers, trend and every keyword. It returns a download link that works for one hour without signing in.

When

When the person needs a client report.

Cost

Not metered.

{
  "url": "https://api.theserpagent.ai/api/reports/1/download?days=30&expires=…&signature=…",
  "expires_in_minutes": 60,
  "filename": "report-alpinerun.example-2026-11-07.pdf"
}

What a project's PDF report carries: company name, colour, whether it has a logo and whether our name is hidden, plus where replies to its scheduled emails go.

When

Before making or changing a client's report.

Cost

Not metered.

{
  "company_name": "Larkfield SEO",
  "color": "#1d4ed8",
  "reply_to": "reports@larkfield.example",
  "hide_branding": true,
  "has_logo": true
}

Puts a company name and colour on a project's PDF report, and chooses whether our name is hidden. The company name also goes on the From line of its scheduled emails, and replies go to reply_to; the sending address stays ours. Only the fields sent change, and null clears one.

When

When the person wants the report under their own name.

Cost

Not metered.

{
  "company_name": "Larkfield SEO",
  "color": "#1d4ed8",
  "reply_to": "reports@larkfield.example",
  "hide_branding": true,
  "has_logo": false
}

Puts a logo on a project's PDF report, from a public image address or base64: PNG or JPEG, up to 512 KB.

When

When the person gives a logo for the report.

Cost

Not metered.

{
  "company_name": "Larkfield SEO",
  "color": "#1d4ed8",
  "hide_branding": true,
  "has_logo": true
}

Takes the logo off a project's PDF report.

When

When the person wants the logo gone.

Cost

Not metered.

{
  "company_name": "Larkfield SEO",
  "color": "#1d4ed8",
  "hide_branding": true,
  "has_logo": false
}

The PDF reports a project emails on a schedule: how often, to whom and when the next one goes out.

When

Before adding or removing a schedule.

Cost

Not metered.

{
  "schedules": [
    {
      "id": 1,
      "frequency": "weekly",
      "recipients": [
        "marketing@alpinerun.example"
      ],
      "next_run_at": "2026-11-09T07:00:00+00:00"
    }
  ]
}

Emails a project's PDF report daily, weekly or monthly to up to 5 people, at 07:00 UTC. A project can hold up to 5 schedules.

When

When the person wants a report sent on its own. It writes to the addresses given, so confirm them first. The tool says so.

Cost

Needs a plan or a running trial.

{
  "schedule": {
    "id": 2,
    "frequency": "weekly",
    "recipients": [
      "marketing@summitbikes.example"
    ],
    "next_run_at": "2026-11-09T07:00:00+00:00"
  }
}

Stops emailing a scheduled report.

When

Only after confirming with the person. The tool says so.

Cost

Not metered.

{
  "deleted": 2
}

The latest plain-English summary of a project, and whether it is from today. Summaries are written automatically from the ranking figures, not by AI.

When

Before writing a new one.

Cost

Not metered.

{
  "summary": {
    "text": "17 of your 18 tracked keywords rank in the top 30, averaging position 8.47, worse than 8.35 before. 3 are in the top 3 and 11 in the top 10. Biggest gain: \"trail running poles\", up 1 to position 3. Biggest drop: \"trail running shoes\", down 3 to position 7. Your share of visibility is 15.5%; trailhouse.example leads with 17.1%. Google shows an AI Overview for 9 of your keywords and cites you in 4.",
    "source": "template",
    "date": "2026-11-07"
  },
  "up_to_date": true
}

Writes today's plain-English summary of a project, automatically from its ranking figures. No AI writes it on our side, so for a fuller write-up read get_overview and get_changes and write it yourself in the conversation; that text does not go into PDF reports. A summary already written today comes back as it is.

When

When the person wants the state of a project in words.

Cost

No allowance. Needs a plan or a running trial.

{
  "summary": {
    "text": "17 of your 18 tracked keywords rank in the top 30, averaging position 8.47, worse than 8.35 before. 3 are in the top 3 and 11 in the top 10. Biggest gain: \"trail running poles\", up 1 to position 3. Biggest drop: \"trail running shoes\", down 3 to position 7. Your share of visibility is 15.5%; trailhouse.example leads with 17.1%. Google shows an AI Overview for 9 of your keywords and cites you in 4.",
    "source": "template",
    "date": "2026-11-07"
  },
  "cached": false
}