FeelingSurf

fr.feelingsurf/feelingsurf · v1.1.0 · browser-automation

FeelingSurf is healthy: it completed an MCP handshake in 1502 ms and exposes 34 tools.

Manage your FeelingSurf traffic exchange account: sites, targeting, templates, sources and proxies.

Endpoint: https://api.feelingsurf.fr/mcp (streamable-http)

No repository listed · Website · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count34
Latency1502 ms
Last checked (UTC)2026-10-16T03:00:09.293Z

Health history

Checked (UTC)StatusLatencyError
2026-10-16T03:00:09.293ZHealthy1502
2026-10-14T23:55:50.198ZNeeds auth1377initialize: HTTP 403

Tools (34)

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 nothing. A fixed reference dataset (~250 countries), returned in full — not pagin
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 others default to a new-site configuration. When `template_id` is given, that te
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 when you upgrade again.
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 has passed, and 403 `site_limit_reached` when you have no free slot.
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 403 `template_limit_reached`. Fields for creating a site template. Only `name` i
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 host and port already on your account returns 422 `validation_error`.
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 after failing. To change the host, port or credentials, delete the proxy and add it
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.