Tracey MCP Server Setup

Overview#

Think of MCP (Model Context Protocol) as giving your AI assistant a direct connection to Tracey's comprehensive XDC blockchain toolkit. Instead of the AI guessing how XDC development works, it can instantly access real blockchain data and execute transactions.

Without MCP:

You: "Check my XDC wallet balance"
AI: *generates generic code that might not work with XDC network*

With MCP:

You: "Check my XDC wallet balance"
AI: *connects to Tracey MCP server*
AI: *executes actual balance check using real XDC RPC calls*
AI: "Your wallet xdc123...456 has 125.67 XDC ($89.43 USD)"

How it helps you#

When you connect MCP to your AI tools, the AI becomes an XDC blockchain expert that can:

• Real Wallet Operations: Connect MetaMask, check balances, transfer XDC/XRC20 tokens
• Live Market Data: Get XDC prices, DEX comparisons, arbitrage opportunities
• Network Analysis: Check transaction status, contract info, gas fee calculations
• DeFi Tools: Simulate swaps, find arbitrage, analyze token portfolios
• News & Events: Get crypto news, calendar events, market insights
• Smart Contracts: Generate and deploy contracts using templates

The Tracey MCP server provides both data access AND execution capabilities - making your AI a fully functional XDC development assistant.

Available Tools#

Wallet & Transaction Tools

• connect_metamask - Connect your MetaMask wallet securely
• get_connected_wallet - Check current wallet connection
• disconnect_wallet - Safely disconnect wallet sessions
• transfer_xdc - Send native XDC tokens
• check_xdc_balance - Check wallet XDC balance
• check_transaction - Verify transaction status
• wallet_history - View transaction history

Market & Trading Tools

• get_xdc_price - Real-time XDC price data
• dex_price_checker - Compare prices across XDC DEXs
• swap_simulator - Simulate token swaps before execution
• arbitrage_finder - Find profit opportunities across DEXs
• token_portfolio - Analyze complete token holdings

Network & Contract Tools

• xdc_network_info - Network statistics and status
• get_contract_info - Smart contract analysis
• calculate_gas_fees - Estimate transaction costs
• write_smart_contract - Generate contracts from templates
• list_contract_templates - View available contract types

Information & Analysis Tools

• news_aggregator - Latest crypto news from multiple sources
• calendar_integration - Important crypto events and dates
• calculator - Basic arithmetic operations
• text_transform - Text manipulation utilities

Claude Setup#

To use the Tracey MCP server with Claude:

1. Add the Tracey MCP server to Claude

1. Navigate to the Connectors page in Claude settings
2. Select Add custom connector
3. Add the following:
   • Name: Tracey XDC Blockchain
   • URL:
     Terminal

     https://mcp.tracey.dev/sse

4. Select Add

2. Access Tracey tools in your chat

1. When using Claude, select the attachments button (the plus icon)
2. Select the Tracey XDC Blockchain connector
3. Query Claude with Tracey's blockchain tools as context

Example usage:

You: "Connect my MetaMask wallet and check my XDC balance"
AI: *uses connect_metamask and check_xdc_balance tools*
AI: "Connected! Your wallet has 847.23 XDC ($592.06 USD)"

Cursor Setup#

To connect the Tracey MCP server to Cursor:

Quick Install

Click the button below to automatically install:

Manual Configuration

1. Open MCP settings

• Use Command + Shift + P (macOS) or Ctrl + Shift + P (Windows) to open command palette
• Search for "Open MCP settings"
• Select Open MCP settings to open the mcp.json file

2. Configure the Tracey server

In mcp.json, add the Tracey configuration:

{
  "mcpServers": {
    "tracey-xdc": {
      "url": "https://mcp.tracey.dev/sse"
    }
  }
}

3. Test the connection

In Cursor's chat, ask:

"Do you have access to an MCP server?"

You should see Tracey's XDC blockchain tools available.

VS Code Setup#

The Tracey MCP server can be configured with VS Code extensions that support MCP:

1. Install an MCP-compatible extension
2. Add the Tracey server URL:
   Terminal

   https://mcp.tracey.dev/sse

3. Test the connection by querying Tracey tools

Note: VS Code MCP support varies by extension. Check your specific extension's documentation for setup instructions.

Authentication Setup#

Some Tracey tools require authentication for enhanced features:

Getting Your Auth Token

1. Visit: https://connector.tracey.dev/auth
2. Complete the authentication process
3. Copy your authentication token
4. Use the token in MCP tool calls that require
   Terminal

   auth_token

   parameter

Tools Requiring Authentication

Most Tracey tools work without authentication, but some advanced features require an auth token:

• Enhanced market data and price feeds
• Advanced portfolio analysis
• Premium news and calendar features
• Higher rate limits for API calls

Testing Your MCP Connection#

Once configured, test your MCP connection:

1. Check available tools

"What MCP tools do you have available?"

You should see the complete list of Tracey XDC blockchain tools.

2. Test basic functionality

"Get the current XDC price"

3. Test wallet connection (optional)

"Connect my MetaMask wallet"

4. Test advanced features

"Find arbitrage opportunities on XDC DEXs"

Use-Case Scenarios#

DeFi Trading Assistant

You: "Check XDC price, find best DEX rates for WXDC/USDT, and simulate a 1000 XDC swap"
AI: *uses get_xdc_price, dex_price_checker, swap_simulator*
AI: "XDC: $0.067 (+2.3%). Best rate on XinSwap: 1 WXDC = 0.0671 USDT. 1000 XDC swap would get you ~67.1 USDT with 0.3% slippage."

Portfolio Management

You: "Connect wallet and show me my complete XDC portfolio with current values"
AI: *uses connect_metamask, token_portfolio, get_xdc_price*
AI: "Portfolio connected! You have 500 XDC ($33.50), 1200 WXDC ($80.52), 45 USDT ($45.00). Total value: $159.02"

Smart Contract Development

You: "Create an ERC20 token contract called TraceyToken with symbol TRC and 1M supply"
AI: *uses write_smart_contract tool*
AI: "Generated TraceyToken (TRC) contract with 1,000,000 tokens. Ready for deployment to XDC Network."

Market Research

You: "Get latest XDC news and upcoming crypto events this week"
AI: *uses news_aggregator, calendar_integration*
AI: "Latest: XDC partners with major bank for CBDC pilot. Upcoming: Token unlock event tomorrow, DeFi conference Friday."

Security Considerations#

Wallet Safety

• Tracey MCP server never stores private keys
• Wallet connections are session-based and expire automatically
• All transactions require explicit user approval in MetaMask
• Session isolation prevents cross-user contamination

API Security

• Authentication tokens are optional for basic features
• Rate limiting prevents abuse
• All network calls use secure HTTPS connections
• Transaction validation before execution

Best Practices

1. Only connect wallets you intend to use
2. Verify transaction details before approval
3. Disconnect wallets when finished
4. Keep authentication tokens secure
5. Use testnet for development and testing

What to read next#

With Tracey MCP configured, your AI tools now have direct access to XDC blockchain functionality:

• XDC Development Guide: Learn XDC-specific development patterns
• DeFi Integration Patterns: Master DeFi development with Tracey tools
• Smart Contract Templates: Find available contract templates
• Trading Bot Examples: Build automated trading strategies

Need help? Visit https://tracey.dev/support or join our Discord community for assistance.