humanity

MCP serverEverything else

Europe's population layer: demographics, spending and market data for every place, down to 1 km².

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use humanity

Install humanity

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user humanity 'https://mcp.hiasynth.co'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://mcp.hiasynth.co

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=humanity&config=eyJ1cmwiOiJodHRwczovL21jcC5oaWFzeW50aC5jbyJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.hiasynth.co

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add humanity --url 'https://mcp.hiasynth.co'

    Run it once, then sign in with codex mcp login humanity if the server asks for an account.

From the project's README

As published by hi-synth/hiasynth-mcp-server in README.md.

Hiasynth Humanity

Query humanity.

The population layer for AI. Demographic, spending and market data for every place in Europe, as one remote MCP server, for your AI assistant or inside your own product.

Nobody could say what a Lyon neighbourhood spends on restaurants, or how many renting families in Bavaria earn above the median. Statistics come as national averages, surveys as small samples, and nothing ties who people are to where they live and what they spend. Hiasynth Humanity models it: all 522 million Europeans, each in a household, each household in its neighbourhood, with a line-by-line budget. That's ~700 attributes per person, queryable in any combination, at any resolution down to 1 km². No real person is in it, so it's private by design.

https://mcp.hiasynth.co

Streamable HTTP · OAuth 2.1 (sign in with your Hiasynth account) or an API key · every tool read-only.

Connect

ClientHow
Claude (web, desktop, mobile)Settings → Connectors → Add custom connector → paste the address. Guide
ChatGPTSettings → Apps → Create → paste the address. Guide
Claude Codeclaude mcp add --transport http hiasynth https://mcp.hiasynth.co Guide
Cursor / VS CodeThe buttons above.
Gemini CLIgemini extensions install https://github.com/hi-synth/hiasynth-mcp-server
Anything elseRemote MCP over streamable HTTP. Guide

Headless clients send an API key from hiasynth.co/app/mcp as Authorization: Bearer …:

{
  "mcpServers": {
    "hiasynth": {
      "url": "https://mcp.hiasynth.co",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Build it into your product

The same server is an API for your features and agents: size a market inside a CRM and show where to dig next, tie a marketing tool's personas to the actual population, or show the wallet size of any neighbourhood.

  • Auth: OAuth 2.1 for user-facing apps, or a server-side API key from hiasynth.co/app/mcp (Authorization: Bearer …).
  • Responses: structured JSON with the numbers already computed: counts, shares, lift against the local baseline, top places, and a confidence tier. Aggregates only, never individual records.
  • Fine control: query_population takes a structured spec (group-by, filters, count/share/avg) for pipelines that need exact shapes.
  • Any MCP client library works: the official SDKs, the Claude and OpenAI APIs' MCP connectors, LangChain, or plain JSON-RPC over HTTPS.

What analyze_market returns for renting families with above-median income in Bavaria (trimmed):

{
  "headline": "418,921 households (6.81% of Bayern). Biggest markets: München, Nürnberg.",
  "segment_size": { "count": 418921, "share_pct": 6.81, "population": 6153349 },
  "core_markets": [
    { "name": "München, Landeshauptstadt", "count": 43674, "local_share_pct": 6.51, "lift": 0.96 },
    { "name": "Würzburg", "count": 5272, "local_share_pct": 8.41, "lift": 1.23 }
  ],
  "hotspots": [
    { "name": "Sonthofen, St", "count": 1111, "local_share_pct": 10.56, "lift": 1.5 }
  ],
  "confidence_tier": "medium",
  "computed": "3 attribute filter(s) over 6,153,349 households at municipality resolution; counted, not estimated"
}

Full reference: Build with Hiasynth.

Try asking

  • How many renting families with above-median income live in Bavaria, and where do they cluster?
  • What do households in La Croix-Rousse, Lyon, spend on restaurants and cafés?
  • Who lives in Södermalm, Stockholm — and how is it different from the rest of Sweden?
  • Which media channels reach women aged 25–40 in the top income quartile in France?
  • Compare Munich, Hamburg and Vienna for affluent 30–45 year olds.
  • What does a typical household in Porto spend on eating out, and how does its carbon footprint compare?

Tools

ToolWhat it answers
analyze_marketHow many people match a segment, who they are, and where they cluster.
describe_areaWho lives in a place — demographics, values, economics, media, spending, footprint.
reach_audienceWhich channels, values and brands over-index for a segment.
compare_placesSide-by-side comparison of places for one segment.
rank_placesRank regions or towns for a segment.
sample_personaRepresentative personas (statistical composites, never a real row).
resolve_placeTurn a name, code, postcode or point into the exact area used.
query_populationStructured group-by for agent builders.
list_attributesSearch the attribute catalogue.

All tools are read-only (readOnlyHint: true), return aggregates only, and suppress any cell under the privacy floor. Special-category attributes are never broken down below region level.

Links

Docs · Pricing · Privacy · Terms · Support

This repository holds the public listing files (registry server.json, Gemini CLI extension). The server itself is operated by Hiasynth AB.

Advanced
Delivery
humanity MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Catalog kind
mcp-server
Key
co-hiasynth-humanity
Source
github.com/hi-synth/hiasynth-mcp-server
Hosted endpoint
https://mcp.hiasynth.co