MCP ServerREST API

Pay through Viaclave from any LLM that speaks MCP

Install in under 60 seconds. Your agent immediately gains the ability to create wallets, send payments, verify transactions, and swap tokens on Solana. No integration code required.

Install

1. Open your MCP config

Open ~/.cursor/mcp.json (create it if it doesn't exist).

2. Add Viaclave

~/.cursor/mcp.json
{
  "mcpServers": {
    "viaclave": {
      "url": "https://mcp.viaclave.com/v2",
      "headers": {
        "Authorization": "Bearer vc_test_YOUR_KEY_HERE"
      }
    }
  }
}

3. Replace the key

Replace vc_test_YOUR_KEY_HERE with your API key from the dashboard. Use a vc_test_ key for test mode (devnet) or vc_live_ for production.

4. Restart Cursor

Restart Cursor to pick up the config. Your agent can now call any Viaclave tool.

JSON-RPC Endpoint

Native MCP Protocol Support

Viaclave speaks the standard MCP JSON-RPC 2.0 protocol. Claude Desktop, Cursor, and any MCP-compatible client can connect directly without adapters.

Endpoint: POST https://mcp.viaclave.com/v2

Protocol: JSON-RPC 2.0 (MCP spec 2025-03-26)

Auth: Authorization: Bearer YOUR_API_KEY

Methods: initialize, tools/list, tools/call, resources/list, resources/read

Resources

The v2 endpoint also exposes MCP resources that your agent can read directly:

  • viaclave://wallets/{id} — Full wallet details including balances and limits
  • viaclave://agents/registry — List of all publicly registered agents

Available tools

Your agent gets access to 25 tools. Here's the full catalog:

create_walletCreate a new custodial Solana wallet
list_walletsList all wallets on your account
get_balanceCheck a wallet's USDC and SOL balance
get_balancesGet all stablecoin balances (USDC, USDT, PYUSD, EURC)
send_paymentSend stablecoins to another Viaclave wallet
send_to_addressSend tokens on-chain to any Solana address
check_paymentCheck the status of a payment
list_transactionsList recent payments for your account
get_deposit_addressGet the on-chain address for deposits
withdrawWithdraw tokens to an external Solana address
swap_tokensSwap between SOL and USDC
verify_transactionVerify any Solana transaction by signature
register_agentRegister a public agent identity
lookup_agentLook up an agent by handle
request_paymentRequest payment from another agent
set_spending_limitsSet daily and per-transaction caps
airdrop_solRequest a devnet SOL airdrop (test mode)
credit_test_usdcCredit test USDC (test mode)
wait_for_paymentLong-poll until a payment completes or fails
verify_payment_receivedVerify a specific payment was received
simulate_paymentDry-run a payment to check limits and balances
retry_paymentRetry a failed payment
wait_for_depositLong-poll until a deposit arrives
get_funding_statusCheck wallet funding recommendations
lookupUniversal lookup by ID, handle, or address

Prefer REST?

Every MCP tool maps 1:1 to a REST endpoint. If you're integrating directly, the REST API gives you the same capabilities with standard HTTP calls.