Connect Normi to VS Code (GitHub Copilot)

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

Create the file below in your project, or run MCP: Add Server from the command palette and choose HTTP. On first start, VS Code detects Normi's OAuth sign-in and opens the browser: sign in to normi.fr and approve VS Code.

{
  "servers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp"
    }
  }
}

Or in one line, in your user profile:

code --add-mcp '{"name":"normi","type":"http","url":"https://mcp.normi.fr/mcp"}'

API-key variant

VS Code asks for the key the first time the server starts (masked field) and stores it securely: it never appears in mcp.json, so you can commit that file.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "normi-api-key",
      "description": "Normi API key (normi_…)",
      "password": true
    }
  ],
  "servers": {
    "normi": {
      "type": "http",
      "url": "https://mcp.normi.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${input:normi-api-key}"
      }
    }
  }
}

Alternative: STDIO package

If remote servers are blocked, run the npm package @normi/mcp-dvf locally. It relays calls to the same Normi server.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "normi-api-key",
      "description": "Normi API key (normi_…)",
      "password": true
    }
  ],
  "servers": {
    "normi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@normi/mcp-dvf"],
      "env": {
        "NORMI_API_KEY": "${input:normi-api-key}"
      }
    }
  }
}

A first prompt to try

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

{
  "commune": "BORDEAUX",
  "periode": { "mois": 24, "date_debut": "2023-12-31", "date_fin": "2025-12-31" },
  "type_local": "Maison",
  "transactions_revente": 2246,
  "flips_detectes": 37,
  "taux_de_flip": 1.65,
  "marge_brute_mediane": 10000,
  "marge_mediane_pct": 3.53,
  "duree_detention_mediane_jours": 646
}

Over the last 24 months of DVF data, 37 of the 2,246 house resales in Bordeaux are “flips” (resold within 18 to 24 months), or 1.65%, with a median gross margin of €10,000 (+3.5%). Addresses are never returned: only aggregates. The response fields are in French because the API's field names are.

Troubleshooting