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 only

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. No other HTTP method is accepted.

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.