English Français العربية

Anwani

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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)>'
إعداد 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "anwani": {
            "command": "npx",
            "args": [
                "-y",
                "anwani-mcp@1.1.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Anwani؟

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

كيف أثبّت Anwani؟

يعمل كخادم بعيد. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Anwani إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Anwani مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Anwani؟

ينشره Anwani-app. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.