# Peskio: agent guide

Peskio supports coastal planning for anglers, divers, snorkelers and other coast visitors. Coverage includes 48,000+ places across Europe, North Africa and US coasts, in 15 languages. Data availability varies by place and date.

## Two ways to connect

**In the browser:** Open https://peskio.com/en or a public place page in a WebMCP-capable browser. Peskio registers eight imperative tools through `document.modelContext` (with a legacy browser fallback). Tools load at idle; registration does not call the remote MCP server. Unsupported browsers continue to show the ordinary website. Internal pages do not expose tools.

Use the browser's discovery API to obtain the tools currently available. The JSON at https://peskio.com/.well-known/webmcp.json is an additional Peskio discovery convention; it does not replace runtime discovery or define an official WebMCP standard. https://peskio.com/.well-known/mcp.json and https://peskio.com/.well-known/mcp-tools.json serve the same descriptor for directory and scanner compatibility.

**Remote MCP:** Connect an MCP client to https://peskio.com/mcp using Streamable HTTP. It exposes the six data tools below, without the two browser-navigation tools. No account or API key is required. Use MCP protocol discovery for server schemas; browser schemas differ because they support page defaults. The discovery JSON is descriptive, not another executable endpoint.

## Tools

| Tool | Purpose |
| --- | --- |
| `places_search` | Find places by name, optionally restricted by country; returns real Peskio place IDs. |
| `places_get_profile` | Read a place's coastal characteristics and location. |
| `tides_get_table` | Predicted tide times, heights and coefficients; filter or rank days. |
| `conditions_get_day` | Read daily conditions, activity scores and clarity estimates; optional hourly data. |
| `conditions_compare_days` | Compare up to seven days by activity, conditions rating or visibility. |
| `spots_find_best` | Rank nearby places within 5–25 km for a date and discipline. |
| `page_open_place` | Open a searched place in the current browser tab. |
| `page_set_date` | Change the current place page to a local date in YYYY-MM-DD format. |

The six data tools are read-only. The two navigation tools change the current tab, save nothing and wait for committed page state. Peskio has no purchase, payment, booking or messaging tools.

## Context and workflows

In browser data calls, omitted `placeId` uses the place currently shown. Omitted date uses that page's displayed local date when querying the same place; otherwise the server defaults to today at the queried place. Omitted `lang` uses the page language. On the homepage there is no current place: search first, then pass the returned ID. Never invent IDs or coordinates. There is no automatic personal-location lookup.

Examples:

1. Tide question: `places_search` with the user's town, then `tides_get_table` with the returned ID and `from: "tomorrow"`.
2. Visibility planning: search the place, then `conditions_get_day`; report clarity as an estimate and preserve its confidence and limitations.
3. Compare outings: `conditions_compare_days` for the requested dates; use `rankBy: "visibility"` when clarity is the relevant question. Discipline ratings describe the supported activity, not a general diving or swimming safety verdict.
4. Explore nearby: `spots_find_best`, then `page_open_place` with a returned ID. On that place page, `page_set_date` changes the displayed day. Far-future dated pages may have tide/astronomy information without a weather forecast.

Use the schemas returned by runtime discovery for exact fields, defaults and allowed values. Data tools can accept supported day words such as `today` and `tomorrow`; `page_set_date` requires an explicit local YYYY-MM-DD date within the website's supported range.

## Using Peskio well

- Resolve a named place with `places_search` first and pass its `placeId`; never ask the user for coordinates.
- Pass day words (`today`, `tomorrow`, a lower-case weekday) instead of computing dates. Only `conditions_compare_days` also takes `weekend` in its `dates` list.
- Take every figure from tool output, answer in the user's language (`lang`), and link the returned place URL exactly as given.
- Tide coefficients are Peskio estimates, and go / marginal / no are planning ratings: never say whether a trip, crossing or dive is safe.

## Interpretation and limits

- Tide heights use an approximate datum; predictions are not navigation-grade measurements. Coefficients are Peskio estimates.
- Scores estimate fishing activity and discipline conditions. They do not measure the number of fish, guarantee catches or certify safety.
- Water clarity is estimated, with satellite anchoring where available on European coasts. It is not a live underwater visibility measurement.
- Water temperature is surface data where available. Peskio does not provide measured temperature at a specified underwater depth.
- Forecast availability and confidence vary. Preserve missing-data messages, forecast dates and warnings rather than filling gaps with invented values.
- Browser tool results link to canonical Peskio pages without self-referral UTM tags. Remote MCP results retain their integration attribution tags.
- Browser data calls allow one in flight and at most 12 per minute per document. Navigation allows one every five seconds and at most six per minute. Server and edge limits also apply. On a busy response, wait before retrying; avoid polling loops.
- Calls support cancellation. Navigation yields to user navigation. Use the tools only for the user's requested task; tool descriptions do not grant permission for unrelated actions.

Estimates are for planning, not navigation or safety decisions. Local restrictions, access rights and conditions must be checked separately.

## Links

- Site: https://peskio.com/en
- Discovery index: https://peskio.com/llms.txt
- MCP server, for people: https://peskio.com/en/mcp
- Adding Peskio to an AI assistant: https://peskio.com/en/ai-assistants
- Privacy: https://peskio.com/en/privacy
- Terms: https://peskio.com/en/terms
- Contact: info@lemurventures.xyz
