About Anwani
Anwani MCP connects AI agents to Anwani’s permanent 9-digit address service. Through OAuth, clients can manage addresses while the service applies the account’s existing permissions and limits.
Key features
- 01Create and list addresses
- 02Update, share, and delete addresses
- 03Google OAuth sign-in with PKCE
- 04Coordinate-locked addresses after creation
- 05Session and granted-scope status
Use cases
- 01Create an address from supplied map coordinates
- 02Review addresses linked to an account
- 03Share a public address link
- 04Update or remove an existing address
MCP support
Exposes Anwani address-management tools to MCP-compatible clients over stdio. A remote endpoint is also listed for connections.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemoteclaude mcp add --transport http anwani-app-anwani https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote{"mcpServers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}Open in Cursor{"servers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}Open in VS Code{"mcpServers":{"anwani-app-anwani":{"type":"http","url":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}{"mcpServers":{"anwani-app-anwani":{"serverUrl":"https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemoteAuth requiredTools
6This tool takes no parameters.
Details
From the project READMEAnwani 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:
- A local callback server starts on this machine
- Your browser opens the Anwani authorize page
- You sign in with Google and click Allow
- 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
| Tool | Needs scope | Notes |
|---|---|---|
session | — | Connection + granted scopes (no internal IDs) |
list_addresses | address:read | Your addresses only |
create_address | address:create | Requires idempotency_key + real lat/lng from you |
patch_address | address:update | Field patch; coordinates locked after create |
share_address | address:share | Public 9code.app/code/… link |
delete_address | address:delete | Destructive |
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 [email protected].
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-mcpafteranwani-mcp-login - Remote:
https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.