@smoothsend/mcp

MCP (Model Context Protocol) server for SmoothSend. Enables AI assistants in Cursor, Claude Desktop, Windsurf, and other MCP-compatible tools to help developers integrate gasless transactions on Aptos and Avalanche (AVAX).

What it does

Once configured, AI assistants in your editor can:

• Answer questions about the SmoothSend SDK and API — Aptos (fee-payer gasless) and AVAX (ERC-4337 account abstraction)
• Generate integration code for any use case, including wagmi, Privy, and backend/Node patterns on AVAX
• Estimate monthly credit costs based on your transaction volume
• Look up Aptos mainnet token addresses (USDC, USDT, WBTC, USDe, USD1)
• Look up AVAX deployed contract addresses (EntryPoint, VerifyingPaymaster, SimpleAccountFactory) and supported tokens, per network (Fuji / mainnet)
• Pull up full documentation for any section (installation, quickstart, examples, billing, and the AVAX equivalents)

Install

npm install -g @smoothsend/mcp

Or run directly with npx (no install needed):

npx @smoothsend/mcp

Configure

Cursor

Add to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):

{
  "mcpServers": {
    "smoothsend": {
      "command": "npx",
      "args": ["@smoothsend/mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "smoothsend": {
      "command": "npx",
      "args": ["@smoothsend/mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "smoothsend": {
      "command": "npx",
      "args": ["@smoothsend/mcp"]
    }
  }
}

Tools

Tool	Description
get_docs	Get documentation for a section. Aptos: overview, installation, quickstart, api-reference, examples, billing. AVAX: avax-overview, avax-quickstart, avax-api-reference, avax-examples
estimate_credits	Estimate monthly Aptos credits given gas_used, gas_unit_price, apt_price_usd, and volume
get_token_address	Get Aptos mainnet asset address for USDC, USDT, WBTC, USDe, USD1
get_avax_addresses	Get AVAX deployed contract addresses (EntryPoint, VerifyingPaymaster, SimpleAccountFactory) and supported tokens for fuji or mainnet
get_code_snippet	Get a code snippet. Aptos: wallet-adapter-setup, use-smooth-send, script-composer-usdc, fee-preview, error-handling, testnet-setup. AVAX: avax-wagmi-setup, avax-sponsored-write, avax-user-pays-erc20, avax-privy-write, avax-backend-client (recommended), avax-backend-sponsored (advanced/manual)

Resources

Resources are doc pages that AI assistants can read directly:

URI	Content
smoothsend://docs/overview	Overview, quick start, pricing (Aptos)
smoothsend://docs/installation	Installation guide (Aptos)
smoothsend://docs/quickstart	Step-by-step quickstart (Aptos)
smoothsend://docs/api-reference	Full API reference (Aptos)
smoothsend://docs/examples	Real-world code examples (Aptos)
smoothsend://docs/billing	Pricing and credit details
smoothsend://docs/avax-overview	AVAX overview — ERC-4337, sponsorship modes, how it differs from Aptos
smoothsend://docs/avax-quickstart	Step-by-step AVAX quickstart — wagmi and Privy paths
smoothsend://docs/avax-api-reference	Full AVAX API reference — provider, hooks, SmoothSendAvaxClient, SmoothSendAvaxSubmitter
smoothsend://docs/avax-examples	Real-world AVAX examples — wagmi, Privy, and backend/Node

Example prompts

Once configured, try asking your AI assistant:

• "How do I add SmoothSend to my Next.js app?"
• "Show me how to send USDC without the user needing APT"
• "My dApp does ~5000 contract calls per month at 200 gas each. How much will SmoothSend cost?"
• "What's the USDC asset address on Aptos mainnet?"
• "How do I handle SmoothSend errors when credits run out?"
• "How do I sponsor gas for my wagmi dApp on Avalanche?"
• "What's the VerifyingPaymaster address on Avalanche Fuji?"
• "How do I submit a sponsored AVAX transaction from a backend script?"
• "How do I use SmoothSend with a Privy embedded wallet on Avalanche?"

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Type check
npm run typecheck

# Run locally
node dist/index.js

Links

• Dashboard: https://dashboard.smoothsend.xyz
• Docs: https://docs.smoothsend.xyz
• npm: https://www.npmjs.com/package/@smoothsend/sdk