FeelingSurf

Connect it to your AI

Claude Code

claude mcp add --transport http feelingsurf https://api.feelingsurf.fr/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://api.feelingsurf.fr/mcp

This server expects extra headers, usually an API key from its maker.

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "feelingsurf": {
      "url": "https://api.feelingsurf.fr/mcp"
    }
  }
}

Tools it offers

34 tools, as the server itself reported during our check on Oct 31, 2026.

• get_accountGet the authenticated account. Account summary plus the earn-side rollup (credits earned today / last 7 days), active FeelingSurfViewer session count, and site-slot usage.
• update_accountUpdate account settings. Update non-sensitive account settings (e.g. `visit_own_sites`, `timezone`). Writable account settings. Provide at least one. Email, password and billing are intentionally not editable via the API
• list_surf_sessionsList your FeelingSurfViewer sessions. Recent FeelingSurfViewer sessions on your account (the earning side), most recent first. These are your own FeelingSurfViewer instances and their IPs.
• get_referralsGet your referral program. Your shareable referral link, how many users you've referred, your commission rate, and commission credits earned.
• get_traffic_availabilityTraffic availability by country. Surfer-traffic availability per country, to guide a site's or template's location targeting. A country with `availability: none` has no surfers delivering visits, so targeting it yields n
• list_sitesList your sites.
• get_siteGet one site.
• create_siteCreate a site. Only `url` is required; every other field defaults to a new-site configuration. Exceeding the account's slot count returns 403 `site_limit_reached`. Fields for creating a site. Only `url` is required; all
• update_siteUpdate a site. Writable fields of a site. For PATCH, provide at least one; only the fields present are changed.
• delete_siteDelete a site.
• list_deleted_sitesList sites you can still restore. Sites you deleted within the retention window, most recently deleted first. Sites removed because a plan downgrade reduced your slot count are not listed: those come back on their own wh
• restore_siteRestore a deleted site. Brings back a site you deleted, with the settings it had. Geo targeting, blocked domains and actions your plan cannot use stay suspended and come back empty. Returns 404 once the retention window
• list_site_screenshotsList a site's FeelingSurfViewer screenshots. Screenshots captured while the app surfed the site. Returns the most recent (up to 24); this list is not paginated.
• get_screenshotGet a screenshot image. Returns the image FeelingSurfViewer captured. The uid is the last path segment of an `images[].url` from list_site_screenshots.
• list_site_templatesList your site templates.
• get_site_templateGet one site template.
• create_site_templateCreate a site template. A template is a reusable bundle of site settings (no url/paused/labels). Only `name` is required; every other field defaults to a new-template configuration. Exceeding the per-account cap returns
• update_site_templateUpdate a site template. Writable fields of a site template. For PATCH, provide at least one; only the fields present are changed.
• delete_site_templateDelete a site template.
• list_traffic_sourcesList your traffic sources. Your own sources plus the shared/built-in ones, referenced by id from a site's `traffic_sources`.
• get_traffic_sourceGet one traffic source. Works for your own sources and for the shared defaults (e.g. id 1, "Direct visits").
• create_traffic_sourceCreate a traffic source. Exceeding the per-account source cap returns 403 `limit_reached`.
• update_traffic_sourceUpdate a traffic source. Provide at least one field.
• delete_traffic_sourceDelete a traffic source.
• list_proxiesList your proxies. Every proxy on your account, oldest first.
• get_proxyGet one proxy.
• create_proxyAdd a proxy. Registers a static proxy. FeelingSurfViewer checks it before any session goes through it, so a new proxy starts with `proven` false. Exceeding the per-account proxy cap returns 403 `proxy_limit_reached`; a h
• update_proxyPause or resume a proxy. Only `enabled` can change. Pausing or resuming clears `last_error` and its error history, and a resumed proxy is checked again at once, so this also brings back a proxy that was switched off afte
• delete_proxyRemove a proxy.
• list_labelsList your labels. Referenced by id from a site's `labels`.
• get_labelGet one label.
• create_labelCreate a label. Exceeding the per-account label cap returns 403 `limit_reached`.
• update_labelUpdate a label. Provide at least one field.
• delete_labelDelete a label.

Questions