CronosMCP Documentation

npm install @cronos-mcp/server-sdk @cronos-mcp/core

npm install @cronos-mcp/client-sdk @cronos-mcp/core

import { createServer } from '@cronos-mcp/server-sdk';

const server = createServer({
  name: 'market-data-server',
  version: '1.0.0',
  description: 'Real-time cryptocurrency market data',
  network: process.env.NETWORK || 'testnet',
  payTo: process.env.WALLET_ADDRESS,
});

server.addTool({
  name: 'get_price',
  description: 'Get current price for a trading pair',
  price: '0', // Free tool
  inputSchema: {
    type: 'object',
    properties: {
      symbol: { type: 'string', description: 'Trading pair (e.g., BTC_USD)' }
    },
    required: ['symbol']
  },
  handler: async (params) => {
    const price = await fetchPrice(params.symbol);
    return { price };
  }
});

server.addTool({
  name: 'get_ohlcv',
  description: 'Get OHLCV candlestick data',
  price: '1000', // $0.001 (1000 atomic units)
  inputSchema: {
    type: 'object',
    properties: {
      symbol: { type: 'string' },
      interval: { type: 'string', enum: ['1m', '5m', '1h', '1d'] },
      limit: { type: 'number', default: 100 }
    },
    required: ['symbol']
  },
  handler: async (params) => {
    const data = await fetchOHLCV(params);
    return { candles: data };
  }
});

import { CronosMCPClient } from '@cronos-mcp/client-sdk';

const client = new CronosMCPClient({
  network: 'mainnet',
  privateKey: process.env.WALLET_PRIVATE_KEY,
  maxBudget: '100000', // $0.10 max per call
});

const result = await client.callTool({
  serverUrl: 'https://market-data.example.com',
  tool: 'get_ohlcv',
  params: {
    symbol: 'BTC_USD',
    interval: '1h',
    limit: 24
  }
});

console.log(result.data);    // Tool response
console.log(result.txHash);  // Payment transaction hash

try {
  const result = await client.callTool({
    serverUrl: 'https://api.example.com',
    tool: 'expensive_analysis',
    params: { data: '...' }
  });
  
  if (result.paid) {
    console.log(`Paid ${result.amount} USDC.e`);
    console.log(`Tx: ${result.txHash}`);
  }
} catch (error) {
  if (error.code === 'BUDGET_EXCEEDED') {
    console.log('Tool price exceeds budget');
  }
}

# Initial request (no payment)
POST /tools/get_ohlcv HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"symbol": "BTC_USD"}

# Server response (402)
HTTP/1.1 402 Payment Required
X-Payment: eyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJjcm9ub3MtbWFpbm5ldCIuLi59

# Retry with payment header
POST /tools/get_ohlcv HTTP/1.1
Host: api.example.com
Content-Type: application/json
X-Payment: eyJ4NDAyVmVyc2lvbiI6MSwic2NoZW1lIjoiZXhhY3QiLi4ufQ==

{"symbol": "BTC_USD"}

# Success response
HTTP/1.1 200 OK
X-Payment-Response: eyJ0eEhhc2giOiIweDEyMzQuLi4ifQ==

{"candles": [...]}

// ⚠️ CRITICAL: Domain params must be EXACT or signature fails!
const domain = {
  name: 'Bridged USDC (Stargate)',  // ✅ EXACT - not 'USD Coin'!
  version: '1',                      // ✅ Must be '1', not '2'
  chainId: 25,                       // Cronos mainnet (338 for testnet)
  verifyingContract: '0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C'
};

const types = {
  TransferWithAuthorization: [
    { name: 'from', type: 'address' },
    { name: 'to', type: 'address' },
    { name: 'value', type: 'uint256' },
    { name: 'validAfter', type: 'uint256' },
    { name: 'validBefore', type: 'uint256' },
    { name: 'nonce', type: 'bytes32' }
  ]
};

const message = {
  from: '0xPayerAddress',
  to: '0xServerAddress',
  value: '1000',
  validAfter: 0,
  validBefore: Math.floor(Date.now() / 1000) + 300,
  nonce: '0x...' // Random 32 bytes
};

const FACILITATOR_URL = 'https://facilitator.cronoslabs.org/v2/x402';

// Verify payment
const verifyResponse = await fetch(`${FACILITATOR_URL}/verify`, {
  method: 'POST',
  headers: { 
    'Content-Type': 'application/json',
    'X402-Version': '1'
  },
  body: JSON.stringify({
    x402Version: 1,
    paymentHeader: encodedPayload,
    paymentRequirements: requirements
  })
});

// Settle payment
const settleResponse = await fetch(`${FACILITATOR_URL}/settle`, {
  method: 'POST',
  headers: { 
    'Content-Type': 'application/json',
    'X402-Version': '1'
  },
  body: JSON.stringify({
    x402Version: 1,
    paymentHeader: encodedPayload,
    paymentRequirements: requirements
  })
});

const result = await settleResponse.json();
// result.event === 'payment.settled' on success
// result.txHash contains the transaction hash
// result.network confirms which network was used

// Success
{ "isValid": true, "invalidReason": null }

// Failure
{ "isValid": false, "invalidReason": "Invalid EIP-3009 signature" }

// Success
{
  "x402Version": 1,
  "event": "payment.settled",
  "txHash": "0xabc123...",
  "from": "0xPayer...",
  "to": "0xSeller...",
  "value": "1000000",
  "blockNumber": 17352,
  "network": "cronos-mainnet",
  "timestamp": "2025-12-30T12:00:00.000Z"
}

// Failure
{
  "x402Version": 1,
  "event": "payment.failed",
  "network": "cronos-mainnet",
  "error": "Authorization already used"
}

server.start(3001, {
  registryUrl: 'https://registry.cronosmcp.xyz',
  projectName: 'Market Data Tools',
  ownerAddress: '0xYourWalletAddress'
});

POST /api/servers HTTP/1.1
Host: registry.cronosmcp.xyz
Content-Type: application/json

{
  "name": "market-data-server",
  "url": "https://api.example.com",
  "description": "Real-time crypto market data",
  "network": "cronos-mainnet",
  "projectName": "Market Data Tools",
  "ownerAddress": "0xYourWalletAddress",
  "tools": [
    {
      "name": "get_price",
      "description": "Get current price",
      "price": "0"
    },
    {
      "name": "get_ohlcv",
      "description": "Get OHLCV data",
      "price": "1000"
    }
  ]
}

// List all servers
const response = await fetch('https://registry.cronosmcp.xyz/api/servers');
const servers = await response.json();

// Filter by network
const mainnetServers = servers.filter(s => s.network === 'cronos-mainnet');

// Find tools by name
const ohlcvTools = servers
  .flatMap(s => s.tools)
  .filter(t => t.name.includes('ohlcv'));

curl -X POST https://market.cronosmcp.xyz/tools/get_price \
  -H "Content-Type: application/json" \
  -d '{"symbol": "BTC_USD"}'

{
  "symbol": "BTC_USD",
  "price": "94250.50",
  "bid": "94248.00",
  "ask": "94253.00",
  "volume_24h": "12543.82",
  "change_24h": "-1.25",
  "timestamp": 1735570422428
}

curl -X POST https://market.cronosmcp.xyz/tools/get_ohlcv \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{"symbol": "BTC_USD", "interval": "1h", "limit": 24}'

{
  "symbol": "BTC_USD",
  "interval": "1h",
  "candles": [
    {
      "timestamp": 1735567200000,
      "open": "94100.00",
      "high": "94500.00",
      "low": "94050.00",
      "close": "94250.50",
      "volume": "523.45"
    },
    ...
  ]
}

curl -X POST https://market.cronosmcp.xyz/tools/get_orderbook \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{"symbol": "BTC_USD", "depth": 10}'

{
  "symbol": "BTC_USD",
  "bids": [
    ["94248.00", "2.500"],
    ["94247.00", "1.250"],
    ...
  ],
  "asks": [
    ["94253.00", "1.800"],
    ["94254.00", "3.200"],
    ...
  ],
  "timestamp": 1735570422428
}

curl -X POST https://market.cronosmcp.xyz/tools/get_trades \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{"symbol": "BTC_USD", "limit": 20}'

{
  "symbol": "BTC_USD",
  "trades": [
    {
      "id": "T123456789",
      "price": "94250.50",
      "quantity": "0.125",
      "side": "buy",
      "timestamp": 1735570422000
    },
    ...
  ]
}

curl -X POST https://onchain.cronosmcp.xyz/tools/get_balance \
  -H "Content-Type: application/json" \
  -d '{"address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150"}'

{
  "address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150",
  "balance": "1250.456789",
  "symbol": "CRO",
  "network": "cronos-mainnet"
}

curl -X POST https://onchain.cronosmcp.xyz/tools/get_token_balance \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{
    "address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150",
    "token": "0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C"
  }'

{
  "address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150",
  "token": {
    "address": "0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C",
    "name": "USD Coin",
    "symbol": "USDC.e",
    "decimals": 6
  },
  "balance": "5000.000000",
  "network": "cronos-mainnet"
}

curl -X POST https://onchain.cronosmcp.xyz/tools/get_transactions \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{"address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150", "limit": 10}'

{
  "address": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150",
  "transactions": [
    {
      "hash": "0x082adcfd2e6110ad03f3d290c4bb63260cd48d0ae9d5e2640567312cca7f2fad",
      "blockNumber": 65144507,
      "from": "0xa7d5e0EA07DCd2b30Fc87719D15Df92a40791150",
      "to": "0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C",
      "value": "0",
      "gasUsed": "65000",
      "status": "success",
      "timestamp": 1735570438000
    },
    ...
  ],
  "network": "cronos-mainnet"
}

curl -X POST https://onchain.cronosmcp.xyz/tools/get_contract_info \
  -H "Content-Type: application/json" \
  -H "X-Payment: <payment_header>" \
  -d '{"address": "0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C"}'

{
  "address": "0xf951eC28187D9E5Ca673Da8FE6757E6f0Be5F77C",
  "name": "USD Coin",
  "symbol": "USDC.e",
  "decimals": 6,
  "type": "ERC20",
  "totalSupply": "1500000000.000000",
  "verified": true,
  "network": "cronos-mainnet"
}

<!-- Option 1: Link to standalone page -->
<a href="https://cronosmcp.com/transfer.html" target="_blank">
  ⛽ Gasless Transfer
</a>

<!-- Option 2: Embed as iframe -->
<iframe
  src="https://cronosmcp.com/transfer.html"
  width="420"
  height="600"
  frameborder="0"
></iframe>

# Run the dashboard locally
cd apps/dashboard
npm install
npm run dev

# Open http://localhost:3000

# Required
WALLET_ADDRESS=0xYourWalletAddress

# Optional
NETWORK=mainnet  # or testnet
PORT=3000

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel --prod

# Install Railway CLI
npm i -g @railway/cli

# Login and deploy
railway login
railway init
railway up

// Network type
type Network = 'cronos-mainnet' | 'cronos-testnet';

// Payment requirements returned in 402 response
interface PaymentRequirements {
  scheme: 'exact';
  network: Network;
  maxAmountRequired: string;
  resource: string;
  description: string;
  payTo: string;
  maxTimeoutSeconds: number;
  asset: string;
}

// Payment payload sent by client
interface PaymentPayload {
  x402Version: number;
  scheme: 'exact';
  network: string;
  payload: {
    from: string;
    to: string;
    value: string;
    validAfter: number;
    validBefore: number;
    nonce: string;
    signature: string;
    asset: string;
  };
}

// Tool definition
interface MCPTool {
  name: string;
  description: string;
  price: string;
  inputSchema?: JSONSchema;
}

// Server registration
interface ServerRegistration {
  name: string;
  url: string;
  description: string;
  network: Network;
  projectName?: string;
  ownerAddress: string;
  tools: MCPTool[];
}