ShoWhere

ShoWhere MCP server

The ShoWhere geomarketing catalogue, queryable in natural language from your MCP client. Anonymous: no key, no account, no OAuth.

Endpoint

https://mcp.showhere.fr/

  • Streamable HTTP
  • JSON-RPC 2.0
  • POST and DELETE

Connection

Connecting the server to your client

https://mcp.showhere.fr/

The server exposes a single endpoint over Streamable HTTP: every message is a JSON-RPC 2.0 request sent by POST, and a DELETE closes a session. GET is not served: the server pushes no notifications.

Both protocol revisions are served on the same URL — the ones that open with initialize and the ones that carry their version on every request. Your client has nothing to pick.

It is anonymous. No API key, no account, no OAuth: the URL is enough.

Request bodies are capped at 64 KB.

Origin header

A request carrying an Origin header from another host is refused, as protection against DNS rebinding. A missing Origin is accepted: that is the nominal case for a server-to-server agent.

Configuring your client

Configuration syntax differs from one client to the next and changes regularly. Declare the server URL as a remote MCP server, following your client's own documentation.

Streamable HTTP transport specification

Tools

What the server can do

Five tools, from browsing the catalogue to municipality-level values.

  • showhere_list_categories

    Categories of the public catalogue, with the number of indicators in each.

    • No parameter.

  • showhere_search_indicators

    Semantic search in natural language across the catalogue: behaviours, equipment, consumption, profiles.

    Returns no figures.

    • query required.
    • limit ≤ 20.

  • showhere_get_indicator

    Public record of an indicator, from the uuid returned by the search, and whether its figures are open on the public server.

    • uuid returned by the search.

  • showhere_resolve_place

    French municipality name to INSEE code.

    • Municipality level only.
    • Name ≤ 100 characters.

  • showhere_get_indicator_values

    Municipality-level values of an open indicator: rate and headcount.

    • Municipality level only.
    • 25 areas per call maximum.

Limits

Quotas and refusals

Quotas

Fixed window, per IP address.

  • 60 calls per minute on the server.
  • Of which 20 calls per minute for showhere_get_indicator_values.
  • Request bodies capped at 64 KB.

Qualified refusals

A refusal is not a schema error: it is explicit and carries a link.

  • Indicator not public.
  • Indicator not found.
  • Granularity refused.
  • Projection missing.
  • Areas not covered.
  • Area cap exceeded.

Discovery

From discovery to quote

Every server response carries a discovery link to the public record of the indicator concerned, on the ShoWhere platform. That page shows the indicator and allows a quote to be requested.

This server is a showcase of the ShoWhere geomarketing catalogue, not the client API. It exposes public indicators and, for those whose figures are open, their municipality-level values.