MCP Server
52 tools for Claude, Cursor, and MCP-compatible AI assistants. Zero-code payment integration.
Quick Setup
Bootstrap (Recommended)
Generate a local config scaffold first:
npx @sardis/mcp-server init --mode simulatedClaude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"sardis": {
"command": "npx",
"args": ["@sardis/mcp-server", "start", "--env-file", ".env.sardis"],
"env": {
"SARDIS_API_KEY": "sk_...",
"SARDIS_API_URL": "https://api.sardis.sh"
}
}
}
}Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"sardis": {
"command": "npx",
"args": ["@sardis/mcp-server", "start", "--env-file", ".env.sardis"],
"env": {
"SARDIS_API_KEY": "sk_..."
}
}
}
}Wallet Tools (8)
| Tool | Description |
|---|---|
sardis_create_wallet | Create new MPC wallet with optional policy |
sardis_get_wallet | Get wallet details by ID |
sardis_list_wallets | List all wallets for current user |
sardis_get_balance | Get wallet balance for the selected rail/token context |
sardis_get_address | Get deposit address for specific chain |
sardis_update_policy | Update wallet spending policy |
sardis_check_policy | Validate transaction against policy |
sardis_archive_wallet | Archive inactive wallet |
Payment Tools (7)
| Tool | Description |
|---|---|
sardis_pay | Execute payment from wallet |
sardis_pay_invoice | Pay structured invoice with line items |
sardis_request_approval | Request human approval for large transaction |
sardis_list_transactions | List transaction history |
sardis_get_transaction | Get transaction details |
sardis_estimate_gas | Estimate transaction gas fees |
sardis_get_tx_status | Check on-chain transaction status |
Treasury Tools (11)
| Tool | Description |
|---|---|
sardis_sync_treasury_account_holder | Sync provider financial accounts |
sardis_list_financial_accounts | List ISSUING/OPERATING accounts |
sardis_link_external_bank_account | Create external bank account record |
sardis_verify_micro_deposits | Verify micro-deposit amounts |
sardis_fund_wallet | Create ACH collection payment |
sardis_withdraw_to_bank | Create ACH withdrawal payment |
sardis_get_funding_status | Get payment status by token |
sardis_get_withdrawal_status | Get withdrawal status by token |
sardis_get_treasury_balances | List treasury balance snapshots |
Virtual Card Tools (5)
| Tool | Description |
|---|---|
sardis_create_card | Issue virtual card from wallet |
sardis_list_cards | List wallet's virtual cards |
sardis_get_card | Get card details (PAN, expiry) |
sardis_freeze_card | Temporarily freeze card |
sardis_cancel_card | Permanently cancel card |
Hold Tools (5)
| Tool | Description |
|---|---|
sardis_create_hold | Reserve funds for future capture |
sardis_capture_hold | Capture held funds (full or partial) |
sardis_release_hold | Release/void a hold |
sardis_list_holds | List active holds |
sardis_extend_hold | Extend hold expiration |
UCP Commerce Tools (6)
| Tool | Description |
|---|---|
sardis_ucp_discover | Discover products from merchant |
sardis_create_checkout | Start checkout session |
sardis_update_checkout | Modify cart items |
sardis_complete_checkout | Complete and pay |
sardis_get_order | Get order details |
sardis_track_fulfillment | Track order shipment |
A2A Agent Tools (4)
| Tool | Description |
|---|---|
sardis_discover_agent | Discover agent via A2A protocol |
sardis_get_agent_card | Get agent's capability card |
sardis_send_a2a_message | Send message to another agent |
sardis_request_payment | Request payment from agent |
Example: Fund Wallet from Bank
User: Fund my wallet with $500 from my bank account
Claude: I'll fund your wallet with $500. Let me check your linked
financial accounts first.
[Uses sardis_list_financial_accounts]
I found your ISSUING account and linked external bank account.
[Uses sardis_fund_wallet]
Done! Funding initiated:
- Amount: $500.00 USD
- Method: Bank Transfer (ACH)
- Expected arrival: 1-2 business days
- Funding ID: fund_abc123Example: Pay with Virtual Card
User: Create a virtual card to pay $50 for GitHub Copilot
Claude: I'll create a virtual card for GitHub Copilot.
[Uses sardis_create_card]
Virtual card created:
- Card: 4242 **** **** 1234
- Expiry: 01/27
- CVV: 456
- Limit: $50.00
- Merchant lock: github.comMPP & Tempo Integration
Connect Sardis to the Model Payment Protocol (MPP) and Tempo network for AI-native payments with policy enforcement and audit trails.
SDK Reference
Official Python and TypeScript SDKs for Sardis. Typed resources and validated models for wallets, payments, cards, policies, and more.