English Français العربية

Anwani

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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)>'
JSON configuration (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
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "anwani": {
            "command": "npx",
            "args": [
                "-y",
                "anwani-mcp@1.1.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is Anwani?

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

How do I install Anwani?

It runs as a remote server. In 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)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Anwani need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Anwani open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Anwani?

It is published by Anwani-app. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.