Mcp MCP Server

Realmint MCP

Agent-native access to the Realmint catalog of tokenized real-world assets (RWAs): scoring, market data, route support, and price history — exposed as native tools over the Model Context Protocol.

The MCP surface is read-only by design. Trade execution lives in the Realmint HTTP API and requires client-side wallet signing — keys never touch the MCP server.

---

What you can ask it

---

Add it to your client

Claude.ai (custom remote connector)

1. Settings → Connectors → Add custom connector
2. Server URL: https://mcp.realmint.io/mcp
3. Auth: none required
4. Save and start asking the example prompts above.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "realmint": {
      "transport": {
        "type": "streamable-http",
        "url": "https://mcp.realmint.io/mcp"
      }
    }
  }
}

Restart Claude Desktop.

Cursor / Cline / Continue / any MCP client

Configure a remote MCP server with:

• URL: https://mcp.realmint.io/mcp
• Transport: streamable-http
• Auth: none

Programmatic

curl -X POST https://mcp.realmint.io/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

You should see 7 tools, each with annotations.title and annotations.readOnlyHint=true.

---

The 7 tools

All tools are read-only. Annotations follow the MCP spec:

readOnlyHint:    true
destructiveHint: false
idempotentHint:  true
openWorldHint:   true

The complete tool catalog with descriptions, inputs, and titles is published in the discovery card.

The Risk & Rights Score

realmint_get_score returns a 0–100 composite plus six per-dimension scores:

• backing — proof of reserves, audit cadence, backing mechanism.
• enforceability — governing law, issuer verification, legal documents.
• control — issuer power risk: freeze, mint, burn, blacklist, upgrade.
• exit — redemption, transferability, KYC/whitelist, settlement, holding periods.
• liquidity — market data, venue count, evidence docs.
• social — recency-weighted Twitter activity; unverified handles penalized.

Suggested decision thresholds:

• composite ≥ 75 → typical case, proceed.
• 55 ≤ composite < 75 → elevated friction (gates, missing audits); review the asset's flags before acting.
• composite < 55 → high risk; abort or require explicit user override.

Tokens with a non-null metadata.lifecycle (migrated, discontinued, abandoned) are score-capped at 49 by policy.

---

Troubleshooting

HTTP 403 — "Invalid Origin header" The server enforces Origin-header validation as required by the Anthropic Connectors Directory. claude.ai, chatgpt.com, mcp.realmint.io, app.realmint.io, and realmint.io are pre-allowed. If you operate from a different origin and need it added, email us at the address below.

Tool returns an empty list The Realmint catalog is curated — at any given time it indexes ~30 assets. Run realmint_list_assets to see the current set before asking about a specific ticker.

Asset ID format Asset IDs are lowercased tickers — xaut, not XAUT; paxg, not PAXG.

metadata.lifecycle is non-null The token has been migrated, discontinued, or abandoned. Trading is disallowed and the score is capped at 49. The lifecycle field tells you why and points to the replacement (if any).

Price history returns coarser buckets than asked The server cascades to coarser buckets (5m → 1h → 1d) when the requested bucket is empty for that asset. Look at effective_granularity in the response for what was actually returned.

---

Security & privacy

• Read-only. No write tools, no trade execution, no destructive operations.
• No PII collected by the MCP server. The optional x-api-key header is used solely for upstream rate-limit identification.
• HTTPS termination via Traefik.
• Origin / Host validation enabled at the FastMCP layer (DNS rebinding protection).
• Privacy policy: https://realmint.io/privacy
• Terms of service: https://realmint.io/terms

---

Versioning & changelog

This connector is versioned alongside the Realmint platform. Substantive changes to tool surfaces or output shapes will be announced in this README and reflected in the discovery card (serverInfo.version).

---

Contact & support

• General: contact@realmint.io
• Realmint web app: https://realmint.io
• API docs: https://api.realmint.io/docs
• Discovery card: https://app.realmint.io/.well-known/mcp/server-card.json

---

Realmint is operated by 0xFútbol Inc, a BVI Business Company (registration 2169115), trading as Realmint. The MCP server source lives in a private repository; the hosted endpoint at https://mcp.realmint.io/mcp is the supported public interface.