Callejear Madrid

What the Callejear Madrid MCP server does

The Callejear Madrid MCP server gives MCP clients access to an official catalog of 9,400 Madrid street codes. It is intended for lookup and comparison, not for open-ended local advice. Street searches handle names and variants, while official codes distinguish streets with the same or similar names.

The service also exposes partial historical counts for services near representative points. These records cover a 500-meter radius around a point, rather than every location along an entire street. Returned information can include source details, measurement dates, partial coverage, and explicit null or missing values.

How it works

Callejear Madrid MCP server tools are available through the free Streamable HTTP endpoint at https://callejear.com/api/mcp. An MCP-compatible client sends tool calls to that endpoint and receives structured results from the Callejear service.

Use the coverage tool first when the availability or scope of a metric matters. It identifies the pilot’s sources, the metrics that are only partly available, and the applicable radius. Street search prioritizes an exact match while ignoring the road-type label and an initial article, then returns textual matches. Results are not ranked as residential preferences.

For nearby-service context, the tool uses the representative point associated with a street record. A result of zero means zero was observed in the supplied data; it does not establish that no service exists. Comparisons accept two to five points and apply the same method to each one.

Setup and configuration

Configure an MCP client to use the Streamable HTTP URL:

• Endpoint: https://callejear.com/api/mcp
• Transport: Streamable HTTP
• Access: described as free
• Server mode: read-only

The endpoint is the relevant setup detail for a client that supports Streamable HTTP MCP connections.

Tools and capabilities

• callejear_get_coverage reports pilot coverage, data sources, partially available metrics, and the 500-meter radius. It does not provide security data or residential recommendations.
• callejear_search_streets searches Madrid street names and variants. It can return official codes, distinguish homonymous streets, and indicate whether coverage is partial or complete for the source date. Coordinates and links may be null.
• callejear_get_street_context returns service records near a street’s representative point. It preserves source information and does not turn the records into assistant instructions.
• callejear_compare_streets compares two to five points using the same method. It retains nulls, partial results, and unknown dates rather than selecting a winner.

Limitations and notes

The Callejear Madrid MCP server is read-only. Its coverage is tied to the sources and dates reported by the service, and some metrics are partial. Context applies to a representative point within 500 meters, not necessarily to the full street. Search does not accept metric filters, and textual ordering should not be interpreted as a ranking of neighborhoods or residential quality.

The service explicitly avoids safety data, residential recommendations, quality-of-life conclusions, and winner selection in comparisons. Agents should present missing or unknown values as returned instead of inferring that an absent record proves absence in Madrid.