Anwani

io.github.Anwani-appPublished by GitHub account Anwani-appv1.1.3Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleProductivity & Workflow

Overview

AI-generated overview

Anwani lets an assistant create, list, update, share and delete permanent 9-digit address codes tied to real-world locations in the user's Anwani account.

What you can do
Check the connection and granted scopes for the signed-in Anwani account, without exposing internal IDs. List the addresses owned by that account, within the same quota as the app and Telegram. Create one address from a real map pin supplied by the user, with an idempotency key. Patch only the fields provided on an existing address, such as instructions; coordinates stay locked. Return the public deep link for an owned address code, and permanently delete an owned address.
When to use it
Useful when you want an assistant to manage Anwani digital addresses from a chat client: registering a new location, updating its details, sharing its public link, or cleaning up addresses you no longer need.
Requirements
A remote endpoint or the npm package anwani-mcp run locally with Node.js 18+ and an MCP-compatible client such as Cursor. An Anwani account, created during Google sign-in if new. A bearer token obtained through the browser OAuth login flow, sent in the Authorization header; tokens are stored locally under the user's home directory.
Before you install
The Authorization bearer token is a credential; keep it out of chats and revoke it by re-running login or contacting support. Creating, patching and deleting addresses change account data, and delete_address is permanent. Addresses count against the account quota, usually 10. The assistant must use a real map pin from the user and never invent coordinates or place names. Photo upload is not available through this client.

Installation

In SourceWeft

  1. Open Anwani in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Anwani-app%2Fanwani-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "anwani": {
      "type": "http",
      "url": "https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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

bash
npm install -g anwani-mcpanwani-mcp-login

Or without a global install:

bash
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):

json
{  "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 [email protected].

From source

bash
git clone https://github.com/Anwani-app/anwani-mcp.gitcd anwani-mcpnode login.mjs

Smoke test

From a clone:

bash
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

Source: README.md at commit 7525040

Tools

6

session

Check that Anwani is connected for this user. Does not return internal IDs.

Takes no parameters.

list_addresses

List addresses owned by the connected Anwani account (same quota as app/Telegram).

Takes no parameters.

create_address

Create one address within the user quota. Requires a real map pin from the user (latitude/longitude). NEVER invent coordinates, city, or display name. If the user did not provide a location (coords, Maps link, or clear place), ask them first — do not call this tool with sample/demo data.

ParameterspincityfloorlabelphonestreetcountrycategorylatituderequiredlongituderequiredownerNamepinEnabled+6 more

patch_address

Patch only provided fields (e.g. instructions). Does not clear omitted fields. Coordinates cannot be changed.

Parameterscoderequiredchangesrequired

share_address

Return the public deep link for an owned address code.

Parameterscoderequired

delete_address

Permanently delete an address owned by the connected account.

Parameterscoderequired

Version history

1
  1. v1.1.3LatestSep 27, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts