MyAurum MCP Server

A Model Context Protocol server that exposes a user's MyAurum estate data to Claude Desktop and other MCP-compatible AI clients.

Read-only in this release. The server only registers read tools, and the API key it uses is enforced GET-only at the MyAurum API layer. Write tools (add_item, add_record, mark_paid, etc.) ship in the next release.

What this gives you

Once connected, Claude (or any MCP client) can answer questions like:

• "What's my gold portfolio worth today?"
• "How much pure gold do I own across all my jewellery?"
• "What did I pay for the bridal set vs what it's worth now?"
• "What does Mum hold across everything?"
• "What properties do I own?"
• "When does my Honda's insurance expire?"
• "Which properties have property tax overdue?"
• "What's coming due in the next 30 days?"
• "Summarise my estate for me."

…by reading directly from your MyAurum account, with live spot/IBJA prices for metals valuation. No copy-paste, no manual context.

Setup

1. Generate a MyAurum API key

Open MyAurum → Settings → Developer access → + Generate new key. Name it something memorable like "Claude Desktop". Copy the key shown — it starts with mya_pk_ and is shown exactly once.

2. Install Node.js

If you don't already have it: download from nodejs.org. Node 20 or newer.

3. Add MyAurum to Claude Desktop

Open Claude Desktop's developer config (Settings → Developer → Edit Config) and add the following under mcpServers:

{
  "mcpServers": {
    "myaurum": {
      "command": "npx",
      "args": ["-y", "@myaurum-app/mcp-server"],
      "env": {
        "MYAURUM_API_KEY": "mya_pk_YOUR_KEY_HERE"
      }
    }
  }
}

Replace mya_pk_YOUR_KEY_HERE with the key you copied from MyAurum settings.

Restart Claude Desktop. You should see "MyAurum" listed under the available MCP servers. Ask Claude something like "List my properties" — it'll call the MCP tool and show you what's in your MyAurum account.

Local development

Clone the repo, npm install, then:

export MYAURUM_API_KEY=mya_pk_...
export MYAURUM_BASE_URL=http://localhost:3000/api   # optional, defaults to production
npm start

Or point Claude Desktop at the local checkout:

{
  "mcpServers": {
    "myaurum": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/server.js"],
      "env": {
        "MYAURUM_API_KEY": "mya_pk_...",
        "MYAURUM_BASE_URL": "http://localhost:3000/api"
      }
    }
  }
}

Available tools

Precious metals (MyDrawer)

| Tool | What it does | | --- | --- | | list_items(metal?, type?, held_by?, goal?, currency?) | List coins, bars, jewellery with current valuation at today's spot/IBJA rates. Filter by metal, item type, holder, or goal tag. | | get_item(id, currency?) | Full detail on one holding — current value, cost basis, gain vs cost, purchase occasion, making charge, holder, nominee. | | get_drawer_snapshot(currency?) | One-call MyDrawer readout: totals by metal/type/purity/goal, top 5 by value, aggregate cost basis vs current value. |

Financial records & properties

| Tool | What it does | | --- | --- | | list_records(category?, status?) | FDs, MFs, bonds, PPF, NPS, EPF, insurance policies. | | get_record(id) | Full detail on one record. | | list_properties(sub_category?, held_by?) | Real estate, vehicles, watches, artwork. | | get_property(id) | Full detail on one property — including bill payment history. |

Cross-cutting

| Tool | What it does | | --- | --- | | get_holdings_by_person(name, role?, currency?) | What does Mum hold? Cross-tab view of items + records + properties by holder or nominee. | | get_upcoming_renewals(days) | Everything coming due in the next N days — insurance, PUC/fitness, property tax, society dues, FD maturities. | | get_overdue_bills() | Anything currently overdue across the estate. | | get_estate_summary() | High-level descriptive summary — counts, totals, live metals valuation, plus gaps (missing nominees, unfiled society nominations). |

All tools are descriptive — they report on the user's data without recommending actions. Investment-advice framing is out of scope per the SEBI guardrail; the consuming AI assistant is responsible for its own interpretive layer.

What's new in 0.2.0

• Live valuation for metals. list_items, get_item, get_drawer_snapshot, and get_estate_summary now compute current value at today's spot/IBJA rates. Defaults to INR; pass currency to switch.
• get_item — singular detail tool for one holding, including cost basis and gain vs cost.
• get_drawer_snapshot — single-call MyDrawer readout with breakdowns by metal, type, purity, and goal.
• get_holdings_by_person — cross-cutting "what does X hold?" view across all asset types.
• No transient catastrophic numbers. If the price endpoint is unreachable, valuation fields are omitted rather than shown as zero or negative.

Privacy

• The MCP server stores nothing. Each request flows through to the MyAurum API and the response goes back to the client.
• The API key lives only in your Claude Desktop config and your environment variables. It never touches our servers (we only hold the SHA-256 hash for validation).
• Encrypted fields in your MyAurum data (lawyer names, policy numbers, addresses) are returned as sanitised projections by default. Full PII requires an opt-in scope on the key — coming in a later version.

Revoking access

MyAurum → Settings → Developer access → Revoke. Takes effect immediately; any tool call using that key from then on returns 401.

License

UNLICENSED — internal use for connecting MyAurum to MCP clients. The MyAurum API and account remain under MyAurum's terms of service.