Transport: MCP streamable HTTP. Stateless JSON-RPC 2.0 over POST; responses are served as server-sent events. An Accept header listing both application/json and text/event-stream is recommended per the MCP spec, but the endpoint tolerates any Accept header (or none). No session is required; each call is independent.

Authentication: none. The endpoint is public, read-only and free.

Fair use: per-client rate limiting applies (bursts of conversational use pass freely; sustained automated crawling is throttled with HTTP 429).

Example

curl -s -X POST https://traffik.ai/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

`traffik_index`

The Traffik Index: this week's published reading of global superyacht movement (100 = an ordinary week), with the recent weekly series. Free, dated, measured.

Parameters: none

`destination_pulse`

How busy a tracked destination is right now, sea and air: yachts 24m+ in port and arrivals over the last 28 days vs the previous 28, plus private-aviation arrivals (jets, turboprops, helicopters — airlines excluded) at the place's executive airports and heliports. Coverage is fen

Parameters: place (required) — Place name, e.g. 'Newport', 'Monaco', 'the Hamptons', 'Teterboro', 'Van Nuys'

`event_attendance`

Measured superyacht attendance at a marquee event (Monaco Grand Prix, Art Basel Miami Beach…): yachts present per past edition, with dates. Historical measured editions only.

Parameters: event (required) — Event name, e.g. 'Monaco Grand Prix'

`busiest_destinations`

The hottest yacht spots right now: tracked harbors ranked by measured yacht arrivals over the last 7 days, plus which harbors are running hottest against their own recent norm. Answers asks like 'the hottest yacht spot this week', 'busiest harbors', 'where is the fleet'.

Parameters: none

`monaco_flotilla`

Show-week fun facts for Monaco, measured live: how many miles of yacht are in the harbor (total combined length, with Grand-Prix-lap and coastline comparisons), which yacht traveled farthest to get here (anonymized: size, builder and origin waters), and the builder league by hull

Parameters: none

`destination_season`

Season-to-date statistics for a tracked yachting destination (since May 1): total measured arrivals, distinct yachts, peak week, peak day, median stay, and current in-port count. Answers asks like 'how has Porto Cervo's season been', 'season stats for Newport'.

Parameters: place (required) — Destination name, e.g. 'Porto Cervo', 'Newport', 'the Hamptons'

Data and honesty

Every answer is generated at ask-time from Traffik's live measured record: public safety broadcasts inside individually reviewed geofences. Counts are floors, not estimates; a vessel that does not broadcast, or water that is not fenced, is not counted, and answers say so. The server returns no personal information and identifies no individuals. Methodology: traffik.ai/methodology.

Scope

This endpoint carries Traffik's free public tier only. Client capabilities — named-yacht monitoring, arrival outlooks, exposure screening, activation tools — are served from the authenticated platform and are not reachable here.

Support

hello@traffik.ai — a person answers, usually the same day. See support.