Odinfun Mcp

Name: Odinfun Mcp
Author: valhallaguide

@valhallaguide

About Odinfun Mcp

odinfun-mcp is a server implementation for Odin.fun based on the Model Context Protocol (MCP). It provides canister asset management and OdinFun API tools, suitable for blockchain asset management and data query scenarios.

#odinfun #mcp #blockchain #asset-management

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "odinfun-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "odinfun-mcp"
      ]
    }
  }
}

Tools

Get the main API documentation

Get price-specific API documentation

Get FAQ documentation

Get documentation for a specific endpoint

Get information about price units in Odin.fun API. All prices returned by API need to be multiplied by 0.001 to convert to actual satoshi values

Get official FAQ information about Odin.fun. Includes details about token pricing, AMM, bonding curve, and platform functionality.

Get the current BTC price, the value is in USD.

Get recently active Odin.fun tokens. Returns an array. Supports pagination with page and limit.

Get Odin.fun tokens with the highest market cap. Returns an array. Supports pagination with page and limit.

Get token information by name or ticker. Returns all tokens whose name or ticker matches the input. There may be multiple tokens with the same name.

Get information for the specified token. Returns a token info object.

Get holders for the specified token. Returns an array. Supports pagination with page and limit.

Get liquidity information for a specific token. Note: All price and BTC values returned are in 0.001 satoshi units. Multiply by 0.001 to get actual satoshi values.

Get comments for the specified token. Returns an array.

Get candlestick (K-line) data for the specified token. Returns an array.

Get trades for the specified token. Returns an array. Supports pagination with page and limit.

Get trades for the specified token by time. Returns an array. Use Id and LastActionTimestamp to get trades in a specific time range.

Get trades for the specified token by user. Returns an array. Use tokenId and user to get trades for a specific user.

Get Odin.fun user list. Returns an array. Supports fuzzy search by username.

Get information for the specified Odin.fun user. Returns a user info object.

Get balance information for the specified Odin.fun user. Returns a user balance info object.

Get the specified token balance for the specified Odin.fun user. Returns a user token balance info object.

Get tokens created by the specified Odin.fun user. Returns an array.

Get tokens favorited by the specified Odin.fun user. Returns an array.

Get user's liquidity positions. Note: All price and BTC values returned are in 0.001 satoshi units. Multiply by 0.001 to get actual satoshi values.

Get activity records for the specified Odin.fun user. Returns an array.

Overview

What is Odinfun Mcp?

Odinfun Mcp is a server implementation for Odin.fun based on the Model Context Protocol (MCP). It provides canister asset management and OdinFun API tools for blockchain asset management and data query scenarios.

How to use Odinfun Mcp?

Install via npm install odinfun-mcp, then build with npm run build. Start the server in stdio mode by default, or add --sse for HTTP+SSE mode or --streamable for HTTP+Streamable mode. You can import and register the tools in your own MCP project or run the server directly.

Key features of Odinfun Mcp

Canister asset management: query balance, withdraw, create tokens
Buy/sell tokens with BTC and by amount
Add and remove liquidity from token pools
OdinFun API tools for market data, holders, comments
User authentication, profile, and activity queries
Global search across tokens, users, and activities

Use cases of Odinfun Mcp

Manage blockchain assets on Odin.fun via MCP tools
Query token market data, price history, and liquidity info
Authenticate user identity and post comments on tokens
Add liquidity to token pools and manage positions
Search and retrieve user profiles, created tokens, and activities

FAQ from Odinfun Mcp

What startup modes does Odinfun Mcp support?

The server supports stdio mode (default), HTTP+SSE mode (with --sse), and HTTP+Streamable mode (with --streamable). Both SSE and Streamable modes can be enabled simultaneously.

How do I install Odinfun Mcp?

Install the package with npm install odinfun-mcp, then run npm run build to compile. The main entry is dist/server.js.

What are the main tool categories in Odinfun Mcp?

The server includes canisterTools for asset management (balance, withdraw, create, buy/sell, liquidity) and odinFunTools for Odin.fun API (authentication, market data, user profile, comments, search).

How do I authenticate with Odinfun Mcp?

Use the odinapi_authIdentity tool, which authenticates using an ICP identity (Ed25519KeyIdentity). This is required for actions like posting comments.

Can I run Odinfun Mcp in HTTP+SSE and HTTP+Streamable modes at the same time?

Yes. Start the server with both --sse and --streamable parameters (e.g., node dist/server.js --sse --streamable) to enable both modes simultaneously.