An agent can connect on its own if it already holds FEELINGSURF_TOKEN.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
Endpoints
remote
auth
reachable
uptime 30d
p50
protocol
last ok
https://api.feelingsurf.fr/mcpstreamable-http
api_key ${FEELINGSURF_TOKEN}
yes
92%
490 ms
2025-11-25
2026-10-20
Tools (34)
create_label
Create a label. Exceeding the per-account label cap returns 403 `limit_reached`.
create_proxy
Add 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`.
create_site
Create 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 template's settings seed the defaults and any field set explicitly here overrides them (shallow, per top-level key).
create_site_template
Create 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` is required; all others default to a new-template configuration.
create_traffic_source
Create a traffic source. Exceeding the per-account source cap returns 403 `limit_reached`.
delete_labeldestructive
Delete a label.
delete_proxydestructive
Remove a proxy.
delete_sitedestructive
Delete a site.
delete_site_templatedestructive
Delete a site template.
delete_traffic_sourcedestructive
Delete a traffic source.
get_accountread-only
Get the authenticated account. Account summary plus the earn-side rollup (credits earned today / last 7 days), active FeelingSurfViewer session count, and site-slot usage.
get_labelread-only
Get one label.
get_proxyread-only
Get one proxy.
get_referralsread-only
Get your referral program. Your shareable referral link, how many users you've referred, your commission rate, and commission credits earned.
get_screenshotread-only
Get a screenshot image. Returns the image FeelingSurfViewer captured. The uid is the last path segment of an `images[].url` from list_site_screenshots.
get_siteread-only
Get one site.
get_site_templateread-only
Get one site template.
get_traffic_availabilityread-only
Traffic 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 paginated.
get_traffic_sourceread-only
Get one traffic source. Works for your own sources and for the shared defaults (e.g. id 1, "Direct visits").
list_deleted_sitesread-only
List 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.
list_labelsread-only
List your labels. Referenced by id from a site's `labels`.
list_proxiesread-only
List your proxies. Every proxy on your account, oldest first.
list_sitesread-only
List your sites.
list_site_screenshotsread-only
List 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.
list_site_templatesread-only
List your site templates.
list_surf_sessionsread-only
List your FeelingSurfViewer sessions. Recent FeelingSurfViewer sessions on your account (the earning side), most recent first. These are your own FeelingSurfViewer instances and their IPs.
list_traffic_sourcesread-only
List your traffic sources. Your own sources plus the shared/built-in ones, referenced by id from a site's `traffic_sources`.
restore_site
Restore 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.
update_accountdestructive
Update 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.
update_labeldestructive
Update a label. Provide at least one field.
update_proxydestructive
Pause 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 again.
update_sitedestructive
Update a site. Writable fields of a site. For PATCH, provide at least one; only the fields present are changed.
update_site_templatedestructive
Update a site template. Writable fields of a site template. For PATCH, provide at least one; only the fields present are changed.
update_traffic_sourcedestructive
Update a traffic source. Provide at least one field.