MCP server · Public API

Run TrafficPeak from your AI agent

Add one MCP server to Claude Code, Codex, Cursor or Claude Desktop. Your agent creates traffic projects, starts and pauses them and reads the numbers. You just ask.

Get your API key Create a free account

Free account first. 6,000 visits to test, no card.

Works with

Claude Code

Codex

Cursor

Claude Desktop

agent — trafficpeak

Ask your agent…

What your agent can do

The same actions as the panel's main flow, exposed as tools. Nothing hidden, nothing extra.

Create projects

Website traffic for a domain from direct, organic, referral, social or AI sources, plus SERP clicks and SimilarWeb projects. The agent asks for the domain, the daily volume and the targeting.

Start, pause, archive

A project is created paused. The agent starts it when you say so, pauses it for the weekend and archives what you no longer need.

Read statistics and balance

Visits per project and per day, a summary across the whole organization, and what is left to spend before anything runs dry.

Stay in its lane

Top-ups, billing and API keys stay in the panel. An agent cannot spend money you did not put on the account.

One prompt, a live project

Ask in the client you already use. The agent calls TrafficPeak and the project is live.

claude — ~/sites

✻ Welcome to Claude Code

mcp: trafficpeak · 17 tools

Same prompt, same tool calls, same answer in every client. These are the calls the MCP server actually ran on a demo account.

Connect in three steps

About two minutes. The key goes into the agent's config, never into the chat.

Create an API key

Open API & MCP in the panel, tick the permissions the agent should have and copy the key. It is shown once; if it is lost, revoke it and create another.

Open API keys in the panel

Add the MCP server

Pick your client and paste the snippet, with your key in place of the placeholder.

Run in your terminal

claude mcp add --transport http --scope user \
  trafficpeak https://api.trafficpeak.io/v1/mcp \
  --header "Authorization: Bearer <your API key>"

Replace the highlighted placeholder with the key from step 1. Once you create a key, the panel shows these snippets already filled in.

Then just ask: “How did my projects do yesterday?”

Just ask

“How did my projects do yesterday?” The agent sees the tools it has and calls them for you. For a smarter agent, add the TrafficPeak skill: one SKILL.md that teaches it the project types, the required fields and to ask before anything that spends balance.

Full setup guide, with the agent skill

Things people ask their agent

Create an organic traffic project for example.com, 500 visitors a day, United States only, keywords “running shoes” and “trail shoes”.

Pause every project until Monday morning.

Which project used the most balance this week, and how many days of balance are left?

Compare last week with the week before for the blog project.

Start the spring landing project again and tell me when the first visits arrive.

List my projects with their status and daily volume as a table.

Tools and permissions

A key carries only the permissions you tick. Every tool is visible to every key; a tool the key cannot use refuses and names the permission that is missing.

Tool	Permission
`list_projectsget_projectget_project_trafficget_traffic_summarylist_serp_keywords`	Project: read
`create_traffic_projectcreate_serp_projectcreate_similarweb_project`	Project: create
`create_serp_keywords`	Project: read, plus create or update
`update_projectstart_projectpause_projectarchive_project`	Project: update
`get_balance`	Balance: read
`check_api_keylist_planslist_traffic_categories`	none

Built so you can hand an agent the keys

Scoped keys

Read, create, update and balance are separate permissions. Give a reporting agent read-only and it cannot touch a project.

Revoke any time

Revocation stops the agent mid-conversation. A new key takes a minute.

One key per agent

Each agent gets its own named key, so the panel shows which one did what and when it was last used.

Money stays in the panel

No tool can buy credits or change billing. The agent sees the balance; it cannot refill it.

Rate limits

Requests are metered per key, and every response carries headers that tell the agent when to wait.

Key in config, not in chat

The snippet puts the key into the client's config file. A key pasted into a conversation stays in its history.

No agent? The same API over REST

Every tool is an endpoint. OpenAPI 3 specification, idempotency keys, stable error codes. Build your own wrapper, or resell traffic under your brand.

Read the API documentation

Questions

What is MCP?

Model Context Protocol is an open standard that lets an AI assistant call tools on a remote server. Claude, Codex, Cursor and many other clients speak it. TrafficPeak serves its API over MCP, so the agent gets the tools without you writing any code.

Do I need a paid plan?

No. Any account can create an API key. A free account comes with 6,000 visits to test. Traffic flows while the balance lasts, and top-ups happen in the panel.

Which clients work?

Claude Code, Codex, Cursor and Claude Desktop have ready snippets above. Any client that supports remote MCP servers over HTTP with a custom header works the same way. Claude Desktop goes through a small bridge, because it starts only local servers.

Can the agent spend my money?

It can start projects that consume balance you already paid for, if its key has the update permission. It cannot buy credits, change billing or create keys. Give a reporting agent a read-only key and it cannot even start a project.

Is there an agent skill?

Yes. One SKILL.md in the open Agent Skills format works in Claude, Codex and Cursor. It teaches the agent the project types, their required fields, and to ask before anything that spends balance. The setup guide in the panel links to it.

Where is the full documentation?

In the panel under API & MCP: quick start, authentication, errors, rate limits, the AI agents guide and the reference of every endpoint.

Give your agent the keys

Create an API key in the panel, paste one snippet, ask.

Get your API key Create a free account

Free account first. No card.