Libermall Card — MCP Server

Model Context Protocol (MCP) server for Libermall Card — a Telegram-native crypto card you top up with USDT and spend like a normal Visa / Mastercard.

Contents: What it answers · Tools · Install · Example · Configuration · Safety · Roadmap · Project

This server lets AI assistants that speak MCP — Claude (Desktop, Code), Cursor, and any other Model Context Protocol client — answer questions about Libermall Card directly: which card types exist, what networks you can fund them with, whether KYC is needed, and current staking rates.

Read-only and safe by design. It exposes only the public catalog. No authentication, no balances, no personal data, no money operations — nothing that could move funds.

What it can answer

• "What crypto cards does Libermall offer, and which need KYC?"
• "How do I top up a Libermall Card — which networks, what fees?"
• "What are the USDT / TON staking rates?"
• "How much does it cost to issue a card?"

Tools

| Tool | Description | |------|-------------| | list_card_products | Card types: name, network, format (virtual / Apple-Google Pay / metal), KYC requirement | | list_deposit_networks | Top-up networks (USDT TRC-20 — no fee — and USDT TON) with fees | | get_staking_rates | Fixed-term USDt plans (APY, minimum) + non-custodial TON liquid staking | | get_issuance_pricing | How issuance works, starting prices, accepted payment methods | | get_card_faq | KYC, top-ups, custody, supported currencies | | get_catalog | The whole catalog in one call |

Install

No install needed — run it on demand with npx:

npx -y @libermall/card-mcp

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "libermall-card": {
      "command": "npx",
      "args": ["-y", "@libermall/card-mcp"]
    }
  }
}

Restart Claude Desktop, then ask: "Using the libermall-card tools, what cards are available and which need KYC?"

Cursor

Settings → MCP → Add new server, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "libermall-card": { "command": "npx", "args": ["-y", "@libermall/card-mcp"] }
  }
}

Any MCP client

Run npx -y @libermall/card-mcp as a stdio MCP server.

Example

You:    What's the cheapest way to top up a Libermall card, and what staking can I get?
Claude: (calls list_deposit_networks + get_staking_rates)
        Cheapest top-up is USDT on TRC-20 (Tron) — no network fee. USDT on TON
        costs ~0.50%. For savings: fixed-term USDt at 8% (30d) / 10% (90d) / 12%
        (180d), $100 minimum, plus non-custodial TON liquid staking.

Configuration

| Env var | Default | Description | |---------|---------|-------------| | LIBERMALL_CATALOG_URL | https://card.libermall.com/api/public/catalog | Public catalog endpoint. Used by default (live data), with the bundled snapshot as automatic fallback on any error. Set to "" to force offline/bundled. |

Data & safety

• Read-only. The server never authenticates, never sees a balance, never issues a card or moves money.
• No personal data. It returns only the public product catalog.
• Rates and prices are indicative — always confirm current terms in the app at card.libermall.com.

Documentation

• API reference — every tool, inputs/outputs, the data model
• Integration guide — Claude Desktop / Claude Code / Cursor / VS Code / Windsurf
• FAQ — developer questions
• OpenAPI — public catalog schema (the data the server serves)
• llms.txt — machine-readable summary for AI agents

Roadmap

• [ ] Publish to npm so npx @libermall/card-mcp works out of the box
• [ ] Live catalog endpoint (LIBERMALL_CATALOG_URL) for always-current rates
• [ ] Listings in MCP registries (Smithery, mcp.so, PulseMCP)
• [ ] Localized catalog (RU/EN)

Project

• Changelog
• Contributing
• Code of Conduct
• Security policy

Links

• 🌐 Website: https://card.libermall.com
• 📦 npm: https://www.npmjs.com/package/@libermall/card-mcp
• 📖 Model Context Protocol: https://modelcontextprotocol.io
• 🐛 Issues: GitHub issue tracker

License

MIT © Libermall Card