Catalog npm
PACKAGE EXPLORERView in registry

@0xcurvy/curvy-mcp

npm

MCP server exposing Curvy protocol operations as tools for AI agents

Versions collected1
Direct dependencies12From release 0.1.0
Last observed20 Oct, 23:04 UTC

README

Current package documentation

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
  1. Create a .env file (optional):
CURVY_ENV=testnet  # or "mainnet"
  1. 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:

EndpointMethodDescription
/sseGETOpens an SSE connection and creates a session
/messages?sessionId=<id>POSTSends messages to an active session

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

Tools

ToolDescription
curvy-get-balancesReturns aggregated token balances for the authenticated wallet
curvy-send-funds-internalSends funds to a .curvy.name recipient within the Curvy system
curvy-withdraw-fundsWithdraws funds to an external wallet address on a specified network
curvy-get-supported-networksLists 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

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases
VersionPublishedDirect dependenciesOpen version
0.1.0Registry latest30 Mar 202612

Package advisories

0
No matching advisories collected

This describes our collected data; it is not a security assessment.

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 23:04 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:c6f11abf5c95655d6dbc67976e23349f1820f57ec45ab29ea23c6cbd9dddd0b8