SERP Empire API & MCP Server

Everything you can do in the SERP Empire dashboard, you can also do from your own code - or simply by asking your AI assistant. We provide a REST API and a native MCP (Model Context Protocol) server, both included in your subscription.

A REST API for your campaigns and your data

Our JSON API is versioned under /api/v1 and secured with personal access tokens that you create yourself. With it you can:

• Create, update, duplicate, pause, archive and delete campaigns
• Manage the countries and locations you target
• Add and update keywords, including their searches per day and priority
• Read aggregated analytics: searches and visits, day by day
• Retrieve your ranking checks and export them as CSV

Reading your last 30 days of analytics is a single request:

curl "https://www.serpempire.com/api/v1/analytics/overview" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Every response uses the same predictable envelope, with pagination, filtering and sorting available on all list endpoints.

An MCP server for your AI assistant

MCP is the open standard that lets AI assistants connect securely to external tools and data. SERP Empire ships a native MCP server, so you can plug your account straight into Claude, Cursor or any MCP-compatible client and simply ask:

• “How did my campaigns perform last month?”
• “Which of my keywords lost positions this week?”
• “Add the keyword ‘best running shoes’ to my French campaign.”

Connecting takes one block of configuration in your MCP client:

{
  "mcpServers": {
    "serp-empire": {
      "url": "https://www.serpempire.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

The MCP server exposes 20 tools covering campaigns, countries, keywords and analytics - exactly the same capabilities as the REST API.

Built with safety in mind

• Read-only tokens. Give your AI assistant a token that can read your analytics but cannot modify or delete a campaign.
• Expiring tokens. Choose a lifetime of 30 days, 90 days or 1 year, and revoke any token instantly.
• Strictly scoped to your account. A token can only ever access the data of the account that created it.

Getting started

1. Sign in to your SERP Empire account.
2. Go to Account → API & MCP.
3. Create a token, choosing its permissions and expiry.
4. Copy it into your script or your MCP client configuration.

The full documentation - every endpoint, every MCP tool, with example requests and responses - is available on that page once you are signed in.

Frequently asked questions

Does the API cost extra?

No. The REST API and the MCP server are included with your subscription. Requests are rate limited to 60 per minute per account.

Which search engines and data are exposed?

All the campaigns you run on SERP Empire, along with their keywords, targeted countries, daily searches and visits, and the individual ranking checks behind them.

Can I use it to build my own dashboard?

Yes. The analytics endpoints return clean daily time series and totals, which makes them straightforward to plug into a reporting tool, a spreadsheet or a client-facing dashboard.

Where do I find my token?

In your account, under Account → API & MCP. Tokens are shown once at creation time, so store them somewhere safe.