Odinfun Mcp

by valhallaguide

2 378 downloads Not rated yet

GitHub

Other

About

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.

Explore

- Canister Asset Management Tools
- Query balance, withdraw, create new tokens
- Buy/sell tokens with BTC, buy/sell by amount
- Add/remove liquidity

- OdinFun API Tools
- User identity authentication, change username, post comments
- Query Odin.fun token list, market data, candlesticks, holders, liquidity, comments, etc.
- Query user assets, created/favorited tokens, liquidity, activity records, and more

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Odinfun Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

npm install odinfun-mcp

- odinapi_authIdentity: Authenticate using ICP identity (Ed25519KeyIdentity)
- odinapi_identity_postComment: Post a comment on a token

`canister_getBalance`

Query token balance

`canister_withdraw`

Withdraw tokens

`canister_createToken`

Create new token

`canister_buyTokenWithBtc`

/ `canister_sellTokenForBtc`: Buy/sell tokens with BTC

`canister_buyTokenAmount`

/ `canister_sellTokenAmount`: Buy/sell tokens by amount

`canister_addLiquidity`

/ `canister_removeLiquidity`: Add/remove liquidity

`odinapi_getPriceUnitInfo`

Get information about price units in Odin.fun API, helping understand how to interpret price values

`odinapi_getFaqInfo`

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

`odinapi_authIdentity`

Authenticate using ICP identity (Ed25519KeyIdentity)

`odinapi_identity_postComment`

`odinapi_market_token_getInfo`

Get detailed token information (price, volume, holders, etc.)

`odinapi_market_token_list`

List tokens with filtering and sorting

`odinapi_market_price_getBTC`

Get current BTC price in USD

`odinapi_market_price_getHistory`

Get token price history (candlestick data)

`odinapi_market_trade_list`

Get trade records for a token

`odinapi_market_liquidity_getInfo`

Get liquidity information for a token

`odinapi_market_liquidity_getUserPositions`

Get user's liquidity positions

`odinapi_comment_getBTCPrice`

Get current BTC price in USD

`odinapi_comment_getTokens`

Get recently active Odin.fun tokens

`odinapi_comment_getTokensByHighestMarketcap`

Get Odin.fun tokens with highest market cap

`odinapi_token_getTradesByTime`

Get token trades by time range

`odinapi_token_getTradesByUser`

Get token trades by specific user

`odinapi_user_profile_getInfo`

Get user profile information

`odinapi_user_profile_list`

List users (with search)

`odinapi_user_assets_getBalances`

Get all token balances for a user

`odinapi_user_assets_getTokenBalance`

Get balance for a specific token

`odinapi_user_assets_getCreatedTokens`

Get tokens created by the user

`odinapi_user_activity_list`

Get user activity history

`odinapi_user_favorite_list`

Get user's favorite tokens

`odinapi_user_favorite_toggle`

Add or remove a token from favorites

`odinapi_social_comment_list`

Get comments for a token

`odinapi_social_comment_post`

`odinapi_social_activity_feed`

Get recent activities across all tokens

`odinapi_social_activity_getTokenActivities`

Get activities for a specific token

`odinapi_tools_price_convert`

Convert price between sats and USD

`odinapi_tools_price_getBTC`

Get current BTC price in USD

`odinapi_tools_search_global`

Search across all entities (tokens, users, etc.)

`odinapi_tools_enhance_tokenData`

Enhance token data with price, liquidity, etc.

`odinapi_tools_enhance_userData`

Enhance user data with balances, activities, favorites, etc.

- canister_getBalance: Query token balance
- canister_withdraw: Withdraw tokens
- canister_createToken: Create new token
- canister_buyTokenWithBtc / canister_sellTokenForBtc: Buy/sell tokens with BTC
- canister_buyTokenAmount / canister_sellTokenAmount: Buy/sell tokens by amount
- canister_addLiquidity / canister_removeLiquidity: Add/remove liquidity

OdinFun API tools are now organized by functional modules for easier use and better AI integration. All tool names are standardized and grouped as follows:

- odinapi_getPriceUnitInfo: Get information about price units in Odin.fun API, helping understand how to interpret price values
- odinapi_getFaqInfo: Get official FAQ information about Odin.fun, including details about token pricing, AMM, bonding curve, and platform functionality

- odinapi_authIdentity: Authenticate using ICP identity (Ed25519KeyIdentity)
- odinapi_identity_postComment: Post a comment on a token

- odinapi_market_token_getInfo: Get detailed token information (price, volume, holders, etc.)
- odinapi_market_token_list: List tokens with filtering and sorting
- odinapi_market_price_getBTC: Get current BTC price in USD
- odinapi_market_price_getHistory: Get token price history (candlestick data)
- odinapi_market_trade_list: Get trade records for a token
- odinapi_market_liquidity_getInfo: Get liquidity information for a token
- odinapi_market_liquidity_getUserPositions: Get user's liquidity positions
- odinapi_comment_getBTCPrice: Get current BTC price in USD
- odinapi_comment_getTokens: Get recently active Odin.fun tokens
- odinapi_comment_getTokensByHighestMarketcap: Get Odin.fun tokens with highest market cap
- odinapi_token_getTradesByTime: Get token trades by time range
- odinapi_token_getTradesByUser: Get token trades by specific user

- odinapi_user_profile_getInfo: Get user profile information
- odinapi_user_profile_list: List users (with search)
- odinapi_user_assets_getBalances: Get all token balances for a user
- odinapi_user_assets_getTokenBalance: Get balance for a specific token
- odinapi_user_assets_getCreatedTokens: Get tokens created by the user
- odinapi_user_activity_list: Get user activity history
- odinapi_user_favorite_list: Get user's favorite tokens
- odinapi_user_favorite_toggle: Add or remove a token from favorites

- odinapi_social_comment_list: Get comments for a token
- odinapi_social_comment_post: Post a comment on a token
- odinapi_social_activity_feed: Get recent activities across all tokens
- odinapi_social_activity_getTokenActivities: Get activities for a specific token

- odinapi_tools_price_convert: Convert price between sats and USD
- odinapi_tools_price_getBTC: Get current BTC price in USD
- odinapi_tools_search_global: Search across all entities (tokens, users, etc.)
- odinapi_tools_enhance_tokenData: Enhance token data with price, liquidity, etc.
- odinapi_tools_enhance_userData: Enhance user data with balances, activities, favorites, etc.

> All tool names and parameters are now standardized and documented in code. See the codebase for full parameter details and usage examples.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "odinfun-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "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.

> This document is also available in 简体中文 and 繁體中文.

Features

- Canister Asset Management Tools
- Query balance, withdraw, create new tokens
- Buy/sell tokens with BTC, buy/sell by amount
- Add/remove liquidity

Installation

npm install odinfun-mcp

Usage

1. Build the project

   npm run build

2. Start the server

The server supports three startup modes:

- stdio mode (default) - For CLI applications and integration:

     npm start

     # or

     node dist/server.js

This uses stdin/stdout for communication, suitable for command-line tools and integration with applications that support stdio-based MCP connections.

- HTTP+SSE mode - For web applications and modern clients (add --sse parameter):

     node dist/server.js --sse

This starts an HTTP server on port 3000 with SSE endpoints:
- /sse - SSE connection endpoint
- /messages?sessionId=<id>&mode=sse - Message handling endpoint
- / - Server status endpoint

- HTTP+Streamable mode - For applications that need streamable responses (add --streamable parameter):

     node dist/server.js --streamable

This starts an HTTP server on port 3000 with streamable endpoints:
- /stream - Stream connection endpoint
- /messages?sessionId=<id>&mode=streamable - Message handling endpoint
- / - Server status endpoint

Note: Both SSE and Streamable modes can be enabled simultaneously:

   node dist/server.js --sse --streamable

3. Integrate with your MCP project
You can import and register these tools in your own MCP server project, or directly run the server provided by this package.

Main Exports & Entry

- Entry file: dist/server.js
- Type declarations: dist/server.d.ts

Main Tools Overview

canisterTools

odinFunTools

OdinFun API tools are now organized by functional modules for easier use and better AI integration. All tool names are standardized and grouped as follows:

System Tools

- odinapi_getPriceUnitInfo: Get information about price units in Odin.fun API, helping understand how to interpret price values - odinapi_getFaqInfo: Get official FAQ information about Odin.fun, including details about token pricing, AMM, bonding curve, and platform functionality

Authentication Tools

- odinapi_authIdentity: Authenticate using ICP identity (Ed25519KeyIdentity) - odinapi_identity_postComment: Post a comment on a token

Market Tools

- odinapi_market_token_getInfo: Get detailed token information (price, volume, holders, etc.) - odinapi_market_token_list: List tokens with filtering and sorting - odinapi_market_price_getBTC: Get current BTC price in USD - odinapi_market_price_getHistory: Get token price history (candlestick data) - odinapi_market_trade_list: Get trade records for a token - odinapi_market_liquidity_getInfo: Get liquidity information for a token - odinapi_market_liquidity_getUserPositions: Get user's liquidity positions - odinapi_comment_getBTCPrice: Get current BTC price in USD - odinapi_comment_getTokens: Get recently active Odin.fun tokens - odinapi_comment_getTokensByHighestMarketcap: Get Odin.fun tokens with highest market cap - odinapi_token_getTradesByTime: Get token trades by time range - odinapi_token_getTradesByUser: Get token trades by specific user

- odinapi_user_profile_getInfo: Get user profile information - odinapi_user_profile_list: List users (with search) - odinapi_user_assets_getBalances: Get all token balances for a user - odinapi_user_assets_getTokenBalance: Get balance for a specific token - odinapi_user_assets_getCreatedTokens: Get tokens created by the user - odinapi_user_activity_list: Get user activity history - odinapi_user_favorite_list: Get user's favorite tokens - odinapi_user_favorite_toggle: Add or remove a token from favorites

Social Tools

- odinapi_social_comment_list: Get comments for a token - odinapi_social_comment_post: Post a comment on a token - odinapi_social_activity_feed: Get recent activities across all tokens - odinapi_social_activity_getTokenActivities: Get activities for a specific token

Common/Utility Tools

- odinapi_tools_price_convert: Convert price between sats and USD - odinapi_tools_price_getBTC: Get current BTC price in USD - odinapi_tools_search_global: Search across all entities (tokens, users, etc.) - odinapi_tools_enhance_tokenData: Enhance token data with price, liquidity, etc. - odinapi_tools_enhance_userData: Enhance user data with balances, activities, favorites, etc.

> All tool names and parameters are now standardized and documented in code. See the codebase for full parameter details and usage examples.

License

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

canister_getBalance

canister_withdraw

canister_createToken

canister_buyTokenWithBtc

canister_buyTokenAmount

canister_addLiquidity

odinapi_getPriceUnitInfo

odinapi_getFaqInfo

odinapi_authIdentity

odinapi_identity_postComment

odinapi_market_token_getInfo

odinapi_market_token_list

odinapi_market_price_getBTC

odinapi_market_price_getHistory

odinapi_market_trade_list

odinapi_market_liquidity_getInfo

odinapi_market_liquidity_getUserPositions

odinapi_comment_getBTCPrice

odinapi_comment_getTokens

odinapi_comment_getTokensByHighestMarketcap

odinapi_token_getTradesByTime

odinapi_token_getTradesByUser

odinapi_user_profile_getInfo

odinapi_user_profile_list

odinapi_user_assets_getBalances

odinapi_user_assets_getTokenBalance

odinapi_user_assets_getCreatedTokens

odinapi_user_activity_list

odinapi_user_favorite_list

odinapi_user_favorite_toggle

odinapi_social_comment_list

odinapi_social_comment_post

odinapi_social_activity_feed

odinapi_social_activity_getTokenActivities

odinapi_tools_price_convert

odinapi_tools_price_getBTC

odinapi_tools_search_global

odinapi_tools_enhance_tokenData

odinapi_tools_enhance_userData

Claude Desktop / Cursor

McpServers

Features

Installation

Usage

Main Exports & Entry

Main Tools Overview

canisterTools

odinFunTools

System Tools

Authentication Tools

Market Tools

User Tools

Social Tools

Common/Utility Tools

License

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`canister_getBalance`

`canister_withdraw`

`canister_createToken`

`canister_buyTokenWithBtc`

`canister_buyTokenAmount`

`canister_addLiquidity`

`odinapi_getPriceUnitInfo`

`odinapi_getFaqInfo`

`odinapi_authIdentity`

`odinapi_identity_postComment`

`odinapi_market_token_getInfo`

`odinapi_market_token_list`

`odinapi_market_price_getBTC`

`odinapi_market_price_getHistory`

`odinapi_market_trade_list`

`odinapi_market_liquidity_getInfo`

`odinapi_market_liquidity_getUserPositions`

`odinapi_comment_getBTCPrice`

`odinapi_comment_getTokens`

`odinapi_comment_getTokensByHighestMarketcap`

`odinapi_token_getTradesByTime`

`odinapi_token_getTradesByUser`

`odinapi_user_profile_getInfo`

`odinapi_user_profile_list`

`odinapi_user_assets_getBalances`

`odinapi_user_assets_getTokenBalance`

`odinapi_user_assets_getCreatedTokens`

`odinapi_user_activity_list`

`odinapi_user_favorite_list`

`odinapi_user_favorite_toggle`

`odinapi_social_comment_list`

`odinapi_social_comment_post`

`odinapi_social_activity_feed`

`odinapi_social_activity_getTokenActivities`

`odinapi_tools_price_convert`

`odinapi_tools_price_getBTC`

`odinapi_tools_search_global`

`odinapi_tools_enhance_tokenData`

`odinapi_tools_enhance_userData`