English Français العربية

Anwani

Registre officiel Autres

Anwani MCP: create and manage permanent 9-digit address codes through OAuth (9code.app).

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http anwani 'https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote' --header 'Authorization: <Bearer anwani_at_… from Anwani OAuth (https://9code.app/authorize)>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "anwani": {
            "type": "http",
            "url": "https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote",
            "headers": {
                "Authorization": "<Bearer anwani_at_… from Anwani OAuth (https://9code.app/authorize)>"
            }
        }
    }
}
NPM package anwani-mcp
Claude Code 
claude mcp add anwani -- npx -y anwani-mcp@1.1.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "anwani": {
            "command": "npx",
            "args": [
                "-y",
                "anwani-mcp@1.1.3"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Anwani MCP
  2. Requirements
  3. Install
  4. Use with Cursor
  5. Tools
  6. Security
  7. From source
  8. Smoke test
  9. Publish / directories
  10. License

Anwani MCP

Anwani MCP connects AI agents to Anwani, the digital address infrastructure for permanent 9-digit address codes tied to real-world locations.

Create, list, update, share, and delete your Anwani addresses through OAuth, with the same ownership, permissions, and account limits used across Anwani.

Works with Cursor and other MCP-compatible clients.

Product page: https://9code.app/ai-agents

Sign-in uses Google OAuth + PKCE in the browser — approve once, then the client saves the token on this machine.

OAuth client id: anwani-cursor

This package is a connection client only. It does not contain Firebase project internals, Firestore paths, or server secrets.

Requirements

  • Node.js 18+
  • An MCP-compatible client (Cursor is supported; others work the same way via stdio)
  • An Anwani account (created automatically during Google consent if you are new)

Install

npm install -g anwani-mcp
anwani-mcp-login

Or without a global install:

npx -y anwani-mcp-login

What happens:

  1. A local callback server starts on this machine
  2. Your browser opens the Anwani authorize page
  3. You sign in with Google and click Allow
  4. The browser returns to localhost — the bridge saves the token automatically

No JSON paste. Never paste codes or tokens into chat.

Fallback (rare): anwani-mcp-login --paste if loopback is blocked on your network.

Use with Cursor

Cursor is the first supported MCP client. Recommended config (always uses the published package):

{
  "mcpServers": {
    "anwani": {
      "command": "npx",
      "args": ["-y", "anwani-mcp"]
    }
  }
}

Then open a new chat and ask Anwani to create or update an address. Provide a real map pin (coordinates or Maps link) — the agent must not invent a location.

Tools

ToolNeeds scopeNotes
session—Connection + granted scopes (no internal IDs)
list_addressesaddress:readYour addresses only
create_addressaddress:createRequires idempotency_key + real lat/lng from you
patch_addressaddress:updateField patch; coordinates locked after create
share_addressaddress:sharePublic 9code.app/code/… link
delete_addressaddress:deleteDestructive

Photo upload is not available via this client — use the Anwani app or Telegram for photos.

Security

  • Tokens live in ~/.anwani-mcp/ (never inside this package).
  • Access tokens are opaque anwani_at_… values.
  • Same account quota as the app / Telegram (usually 10 addresses).
  • Revoke by running login again (re-consent invalidates prior tokens) or email support@9code.app.

From source

git clone https://github.com/Anwani-app/anwani-mcp.git
cd anwani-mcp
node login.mjs

Smoke test

From a clone:

node smoke.mjs

Publish / directories

See PUBLISH.md for Official MCP Registry, Glama, Smithery, and npm.

  • Local (any MCP client, e.g. Cursor): npx -y anwani-mcp after anwani-mcp-login
  • Remote: https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote

License

MIT

Questions fréquentes

Qu'est-ce que Anwani ?

Anwani MCP: create and manage permanent 9-digit address codes through OAuth (9code.app).

Comment installer Anwani ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http anwani 'https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote' --header 'Authorization: <Bearer anwani_at_… from Anwani OAuth (https://9code.app/authorize)>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Anwani ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

Anwani est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Anwani ?

Il est publié par Anwani-app. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.