Connect Normi to Claude Code

Before you start

• A Normi account: sign in with Google, 500 free credits a month.
• For the API-key connection or the STDIO package: a normi_… key, created in Dashboard → Tokens. It is shown only once.
• For the STDIO package: Node.js 18 or later (npx).

Remote connection (HTTP Streamable)Recommended

Add the server, then run /mcp inside Claude Code: it opens the Normi sign-in page. No key to copy. --scope user makes Normi available in all your projects.

claude mcp add --transport http --scope user normi https://mcp.normi.fr/mcp
# then, inside Claude Code:
/mcp

Check the connection status:

claude mcp list
# normi: https://mcp.normi.fr/mcp (HTTP) - ✔ Connected

API-key variant (CI, remote machine)

Without a browser, pass a key in the Authorization header:

export NORMI_API_KEY=normi_YOUR_TOKEN
claude mcp add --transport http --scope user normi https://mcp.normi.fr/mcp \
  --header "Authorization: Bearer $NORMI_API_KEY"

To share the config with your team, commit a .mcp.json at the project root. Claude Code replaces ${NORMI_API_KEY} with each developer's environment variable, so the key never ends up in Git.

{
  "mcpServers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${NORMI_API_KEY}"
      }
    }
  }
}

Alternative: STDIO package

The npm package @normi/mcp-dvf runs locally and relays calls to the same Normi server. The -- separates Claude Code's options from the server command.

claude mcp add --env NORMI_API_KEY=normi_YOUR_TOKEN --transport stdio normi \
  -- npx -y @normi/mcp-dvf

A first prompt to try

The agent calls analyze_dpe_price_premium (10 credits). An excerpt of the real response, captured on 10 October 2026 against the 2014–2025 DVF data:

{
  "classes": {
    "A": { "count": 669,  "median_prix_m2": 9217, "vs_median_pct": -0.8 },
    "B": { "count": 241,  "median_prix_m2": 9543, "vs_median_pct": 2.7 },
    "C": { "count": 1678, "median_prix_m2": 9501, "vs_median_pct": 2.3 },
    "D": { "count": 5303, "median_prix_m2": 9354, "vs_median_pct": 0.7 },
    "F": { "count": 4366, "median_prix_m2": 9206, "vs_median_pct": -0.9 },
    "G": { "count": 1808, "median_prix_m2": 9286, "vs_median_pct": 0 }
  },
  "summary": "Class B homes sell at +2.7% vs. median; class F at -0.9%"
}

In Paris 11 the gap stays small: from -0.9% (class F) to +2.7% (class B) around the median, over more than 20,000 sales matched to a DPE. The medians are not adjusted for location or year of sale: this is a description, not a measured “green premium”.

Troubleshooting