curvy-mcp

An MCP (Model Context Protocol) server that exposes Curvy protocol operations as tools for AI agents. Built with the @modelcontextprotocol/sdk and @0xcurvy/curvy-sdk.

Features

• Get Balances — View aggregated token balances across all supported networks
• Send Funds (Internal) — Transfer funds to other Curvy users by their .curvy.name
• Withdraw Funds — Withdraw funds to any external wallet address on a supported network
• Get Supported Networks — List all available networks and their IDs

Prerequisites

• Node.js (ES2022+)
• pnpm

Setup

1. Install dependencies:

pnpm install

2. Create a .env file (optional):

CURVY_ENV=testnet  # or "mainnet"

3. Start the server:

pnpm start

On first run, a browser window will open for authentication via app.curvy.box. Your wallet credentials are saved to ~/.curvy/wallet.json for subsequent runs.

Usage

The server runs on port 3001 and exposes two transport endpoints:

| Endpoint | Method | Description | |---|---|---| | /sse | GET | Opens an SSE connection and creates a session | | /messages?sessionId=<id> | POST | Sends messages to an active session |

Connect any MCP-compatible client to http://localhost:3001/sse to start using the tools.

Tools

| Tool | Description | |---|---| | curvy-get-balances | Returns aggregated token balances for the authenticated wallet | | curvy-send-funds-internal | Sends funds to a .curvy.name recipient within the Curvy system | | curvy-withdraw-funds | Withdraws funds to an external wallet address on a specified network | | curvy-get-supported-networks | Lists all supported networks and their IDs |

Library Usage

The package also exports its tools and SDK helpers for use as a library:

import { tools, initSDK, Tool } from "curvy-mcp/lib";

Development

pnpm build    # Compile TypeScript
pnpm start    # Build and run

License

ISC