HoodEx for Developers

Connect HoodEx neighbourhood data to Claude, Cursor, Copilot, and any AI tool over the Model Context Protocol (MCP). Query livability scores, climate, travel access, points of interest, and more — directly from your AI assistant.

What is the HoodEx MCP server?

The HoodEx MCP server exposes real neighbourhood analysis data via the open Model Context Protocol standard. Your AI tool connects once, then you can ask natural-language questions about any neighbourhood worldwide and get structured, real-time answers.

How to connect

1. Add HoodEx as a connector — in your AI tool (Claude, Cursor, Copilot, or any MCP client), choose "Add custom connector" and paste the HoodEx MCP address: https://hoodex.app/mcp
2. Sign in or add your key — sign in with your HoodEx account when prompted, or paste an API key. Signing in unlocks your personal data and report creation.
3. Ask away — your AI tool can now answer questions using live HoodEx data: "Show me the top neighbourhoods in Athens" or "Compare Chelsea and Le Marais".

Available tools

Explore neighbourhoods

• Search a neighbourhood by name
• Get a full neighbourhood detail report
• Compare two neighbourhoods side by side
• List the top-scoring areas in any city or country
• Read AI-written neighbourhood narratives
• Filter by score profile (e.g. high nature + high transport)

Dive into the details

• Climate & seasonal weather data
• Travel & commute accessibility (commute times, transit scores)
• Crime, safety & real-estate research
• Component-level score breakdowns
• Nearby points of interest & parks
• Street-level detections and community questions

Your own data (requires sign-in)

• List your own analyses
• See your saved locations
• Start a brand-new neighbourhood analysis (spends one credit)

Security

• Read-only by default — a plain API key can only read public data; it can never change anything or create reports.
• Spending is protected — starting a report needs a signed-in account and an explicit confirmation flag.
• Private data stays private — your own reports and saved places are only reachable when you're signed in, scoped to just you.
• Abuse limits — rate limits cap how fast anyone can call the server, with a tighter cap on report creation.

MCP endpoint: https://hoodex.app/mcp

Read the full developer guide →