# StableMesh

> StableMesh is an agentic portal for card and crypto: one USD account, funded in stablecoins (USDT or USDC), spent with virtual cards, and run by your AI agent from the web, Telegram, or any MCP client.

How it works:

1. Sign up at https://app.stablemesh.io and complete identity verification (KYC).
2. Deposit USDT or USDC to your personal deposit address. It is credited to your balance in US dollars. Always check the network before sending; funds sent on the wrong network are lost.
3. Open a virtual card and fund it from your USD balance. Use it for subscriptions, ads and travel.

## What people spend on

One card per purpose, all funded from the same USD balance:

- Ads: Meta and Google ad accounts, one card per ad account
- AI tools: ChatGPT, Claude and Cursor subscriptions and usage bills
- Business billing: cloud, SaaS and team tools on named cards; a card can only spend what is on it
- Apple Pay and Google Pay: add a virtual card to a phone and pay in store (on cards that support mobile wallets)

## Channels

- [Web app](https://app.stablemesh.io): the full dashboard for cards, deposits and statements.
- [Telegram bot](https://t.me/stablemesh_bot): balances, cards and deposits from chat.
- MCP server: `https://mcp.stablemesh.io/mcp/sse` for Claude and other MCP clients.

## Connect an MCP client

- Transport: SSE, remote. Endpoint: `https://mcp.stablemesh.io/mcp/sse`
- Auth: OAuth 2.1 with PKCE (S256) and dynamic client registration. The user signs in with their StableMesh account and approves the client.
- Authorization server metadata: https://mcp.stablemesh.io/.well-known/oauth-authorization-server
- Protected resource metadata: https://mcp.stablemesh.io/.well-known/oauth-protected-resource/mcp/sse
- Scopes: `cards:read`, `wallet:read`, `withdraw:read`, `profile:read`, `cards:write`

Claude Code:

```
claude mcp add --transport sse stablemesh https://mcp.stablemesh.io/mcp/sse
```

Then run `/mcp` inside Claude Code to sign in.

Claude (web and desktop): Settings → Connectors → Add custom connector, paste the endpoint URL, then Connect.

Other clients:

```json
{ "mcpServers": { "stablemesh": { "url": "https://mcp.stablemesh.io/mcp/sse" } } }
```

## What an agent can do

Every tool acts only on the signed-in user's own account.

Read:

- `list_cards`, `get_card_detail`, `get_card_balance`: the user's cards and card balances
- `list_card_transactions`: card transactions, newest first
- `get_funding_account`: the USD balance that pays for cards
- `list_wallet_assets`, `get_wallet_balance`: crypto assets per currency and network
- `get_deposit_address`: the user's deposit address for a network and currency
- `list_bills`: deposits, card spend and refunds in one history
- `get_fee_and_limit`: the user's fees and limits
- `can_create_card`, `get_plan_info`: how many more cards the user may open
- `list_card_bins`: card products (information only)
- `get_user_profile`: the user's own profile and KYC status

Write:

- `freeze_card`, `unfreeze_card`: block or resume new transactions on a card
- `update_card_alias`: rename a card
- `deposit_to_card`: move USD from the user's balance onto one of their cards
- `withdraw_from_card`: move USD off a card back to the user's balance

## What an agent cannot do

- Send money to an outside address or withdraw on-chain
- Open a new card (the user does that in the app)
- Read a full card number, CVV or expiry (the user sees those in the app)
- Act on any other user's account

## Docs

- [Documentation](https://stablemesh.gitbook.io/docs/home/stablemesh-doc): getting started, deposits, cards
- [Fees & limits](https://stablemesh.gitbook.io/docs/home/stablemesh-doc/fees-limits)
- [Docs index for agents](https://stablemesh.gitbook.io/docs/llms.txt)
- 中文文档: https://stablemesh.gitbook.io/docs/home/stablemesh-doc/zhong-wen-wen-dang/zh

## Contact

- Email: contact@stablemesh.io
- Telegram: https://t.me/stablemesh_bot