Introducing the FeelingSurf MCP server

Introducing the FeelingSurf MCP server

Hello FeelingSurf community!

After the FeelingSurf API, here is the next step: the FeelingSurf MCP server. It connects AI assistants such as Claude Code, Cursor or any other client that supports the Model Context Protocol (MCP) to your account on our traffic exchange. Instead of writing code, you describe what you want and the assistant does it for you.

Like the API, it's available on every plan.

Connect in a minute

First, create your API key under Settings → API in your dashboard.

In Claude Code, run:

claude mcp add --transport http feelingsurf https://api.feelingsurf.fr/mcp --header "Authorization: Bearer YOUR_API_KEY"

In Cursor and other clients, add this server to the MCP configuration:

{
  "mcpServers": {
    "feelingsurf": {
      "url": "https://api.feelingsurf.fr/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

That's it. Your assistant now sees the FeelingSurf tools and can use them whenever a request calls for it.

What you can ask

Here are a few things you can say, and what the assistant does behind the scenes.

Add a site with its settings in one go

Add https://example.com, send it mobile visits only, and stop at 200 visits a day.

The assistant creates the site with mobile as the only device and a daily limit of 200. If you have a site template, you can also say "add it with my Blog template" and it starts from that template's settings.

Act on a whole group of sites

Pause every site with the Shop label.

The assistant looks up your labels, finds the sites that carry Shop and pauses each one. "Resume them" undoes it later.

Check your numbers

How many credits did I earn over the last 7 days, and how many FeelingSurfViewer sessions are running right now?

Both answers come from your account summary. You can follow up with "and how much did my referrals bring in?" to get your referral commission too.

Find what needs attention

Which of my sites have used up their total visit limit?

The assistant lists your sites and points out the ones that stopped receiving visits because they used up their total visit limit, so you can raise it or leave it as is.

Undo a mistake

I deleted my portfolio site yesterday, can you bring it back?

Deleted sites stay restorable for 90 days. The assistant finds it in your recently deleted sites and restores it.

Plan your targeting (Premium)

Which European countries have high traffic availability? Target my landing page at them, and only send visits on weekdays from 9:00 to 18:00, Paris time.

The assistant checks traffic availability by country, keeps the European countries rated high, then sets the location targeting and the active hours. Your plan applies just like in the dashboard: on a free account, the assistant tells you these settings are reserved for Premium instead of changing them.

You stay in control

The assistant only reaches your own account, sharing the rate limit of your API key (higher for Premium members). Updates and deletions are flagged as such, so assistants that support it ask for your confirmation before running them. You can revoke your API key at any time from Settings → API, which disconnects every assistant using it.

Setup instructions are also on the MCP page, and every tool mirrors an endpoint documented at api.feelingsurf.fr. As always, if you have questions or feedback, get in touch.