@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.

What it does

Once configured, AI assistants in your editor can:

• Answer questions about the SmoothSend SDK and API
• Generate integration code for any use case
• Estimate monthly credit costs based on your transaction volume
• Look up Aptos mainnet token addresses (USDC, USDT, WBTC, USDe, USD1)
• Pull up full documentation for any section (installation, quickstart, examples, billing)

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: overview, installation, quickstart, api-reference, examples, billing
estimate_credits	Estimate monthly 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_code_snippet	Get a code snippet: wallet-adapter-setup, script-composer-usdc, fee-preview, error-handling, testnet-setup

Resources

Resources are doc pages that AI assistants can read directly:

URI	Content
smoothsend://docs/overview	Overview, quick start, pricing
smoothsend://docs/installation	Installation guide
smoothsend://docs/quickstart	Step-by-step quickstart
smoothsend://docs/api-reference	Full API reference
smoothsend://docs/examples	Real-world code examples
smoothsend://docs/billing	Pricing and credit details

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?"

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