Coin MCP Server
Lightning-fast cryptocurrency price server powered by FastMCP.
Key Features
Use Cases
README
Coin MCP Server 🚀💰
Welcome to the Coin MCP Server – your one-stop shop for snagging the latest cryptocurrency prices faster than you can say "To the moon!" 🌙 Built with FastMCP and spiced up with zod for validation, this little server is here to fetch token prices from Bitget’s API like a trusty crypto butler. 🧑💼
中文文档 | English
What Does It Do? 🤔
This project spins up a server that lets you query the current price of any cryptocurrency (paired with USDT) using Bitget’s slick API. Want to know how much your favorite token is worth right now? Just ask, and boom – the price is yours! 💸
-
Tool:
getTokenPrice -
Mission: Fetch the latest price of a token (e.g.,
BGB,BTC,ETH). -
Superpower: It’s fast, it’s simple, and it’s powered by
FastMCP! ⚡ -
Tool:
getAnnoucements -
Mission: get annoucements
-
Tool:
getCoinInfo -
Mission: Get detailed information about a specified token.
-
Superpower: Provides detailed information such as token transferability, supported chain list, chain network status, etc.
Features 🌟
- 🎯 Dead-Simple API: Pass a token symbol, get a price. No fuss, no muss.
- 🛡️ Zod Validation: Parameters are checked tighter than a vault door.
- 📡 Bitget Integration: Pulls live data straight from Bitget’s market ticker API.
- 🧠 Error Handling: Catches hiccups like a pro and logs them for you to giggle at later.
Getting Started 🏁
Ready to dive into the crypto price pool? Here’s how to get this baby running:
Prerequisites
- Deno: You’ll need Deno installed because we’re fancy and modern. Grab it here.
- Bitget API Access: No API key needed – we’re hitting the public endpoint like champs! But if you’ve got a custom
BGURL, set it as an environment variable.
Installation
- Clone this repo like it’s hot:
bash
git clone https://github.com/pwh-pwh/coin-mcp-server.git cd coin-mcp-server - Install dependencies (Deno handles this automagically via imports!).
Running the Server
Fire it up with:
deno run --allow-net --allow-env --allow-read main.ts
or
deno run --allow-net --allow-env --allow-read https://deno.land/x/coin_mcp_server/main.ts
--allow-net: Lets us talk to Bitget’s API.--allow-env: Grabs yourBGURLenv variable if you’ve set one.
The server will start in stdio mode, ready to serve up prices like a crypto vending machine! 🍔
- Support installation-free, directly deploy to deno, fork this project, log in dash.deno.com, set the environment variable StartType=sse to use the domain name provided by deno to connect in sse mode
Configuration
config.json
{
"mcpServers": {
"coin-mcp": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"https://deno.land/x/coin_mcp_server/main.ts"
]
}
}
}
Usage Example 🎮
Here’s how you’d call getTokenPrice:
{
"tool": "getTokenPrice",
"parameters": {
"token": "BGB"
}
}
Response:
"42.069" // The latest BGB/USDT price (not a real price, just vibes!)
If the token doesn’t exist or the API hiccups, it’ll throw an error with a cheeky log to remind you it tried its best. 😅
Code Sneak Peek 👀
Here’s the magic behind the curtain:
- FastMCP: Spins up the server with a cool name and version.
- Zod: Keeps your
tokenparameter in check. - Bitget API: Fetches ticker data from
https://api.bitget.com/api/v2/spot/market/tickers.
The getBitgetPrice function is the MVP, grabbing that sweet lastPr (last price) from the response. Check the logs for price updates or error comedy gold! 😂
Environment Variables 🌍
BGURL: Custom Bitget API base URL (defaults tohttps://api.bitget.comif not set). Set it like:bashexport BGURL="https://your-custom-bitget-url.com"
Troubleshooting 🛠️
- “HTTP error! status: 404”: Double-check your token symbol.
BGBUSDTisn’t the same asBGB! - “Network error”: Make sure you’ve got internet and Deno’s
--allow-netflag. - Still stuck?: Yell into the void (or open an issue). We’ll figure it out together! 🙌
Why This Exists 🎉
Because who doesn’t want to know the price of their crypto stash in real-time? Whether you’re a trader, a HODLer, or just crypto-curious, this server’s got your back. Plus, it’s a fun way to flex some Deno skills and play with APIs. 😎
Contributing 🤝
Got ideas? Found a bug? Want to add a feature like moon phase price predictions? Fork it, tweak it, PR it! Let’s make this the coolest MCP server in the galaxy. 🌌
License 📜
MIT – Do whatever you want with it, just don’t blame me if your token moons or dumps! 🌑📉
Happy crypto hunting, and may your bags always be green! 💚
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Coincap MCP
Query live cryptocurrency data through Coincap's public API for desktop AI tools.
Coincap MCP provides seamless access to cryptocurrency market data from Coincap's public API without requiring API keys or registration. Designed to integrate with Claude Desktop using the Model Context Protocol (MCP), it enables users to query crypto asset prices, market capitalization, and a list of available assets. Installation and configuration are streamlined through Smithery or direct setup. The tool includes sample prompts and exposes specialized tools for crypto price lookup and asset listing.
- ⭐ 89
- MCP
- QuantGeekDev/coincap-mcp
Bitcoin MCP Server
Real-time Bitcoin blockchain data server for MCP clients.
Provides tools to deliver real-time Bitcoin blockchain data for use with Model Context Protocol (MCP) clients. Offers specialized endpoints for querying blockchain addresses, transactions, UTXOs, and block information by interfacing with the mempool.space API. Supports easy installation and integration with popular MCP clients, enabling seamless access to blockchain analytics.
- ⭐ 0
- MCP
- JamesANZ/bitcoin-mcp
Twelve Data MCP Server
Seamless AI-powered access to financial market data via the Twelve Data API.
Twelve Data MCP Server provides a Model Context Protocol-compliant server for integrating and accessing Twelve Data’s financial market API. It enables users and AI agents to retrieve historical data, real-time quotes, and instrument metadata for stocks, forex, and crypto using natural language or endpoint calls. The system leverages AI-driven routing, including OpenAI GPT-4o, to intelligently map plain English queries to relevant API endpoints for structured or conversational workflows. Integration options are available for platforms like Claude Desktop and VS Code, with flexible local or remote deployment.
- ⭐ 43
- MCP
- twelvedata/mcp
BGG MCP
Model Context Protocol server for BoardGameGeek data, collections, pricing, and recommendations.
BGG MCP provides access to BoardGameGeek data via the Model Context Protocol, enabling AI assistants to retrieve and filter information on board games, user collections, prices, and gameplay recommendations. Implemented in Go, it leverages BoardGameGeek APIs and includes advanced tools such as rule question answering and game trading discovery. Additional integrations include real-time price data from BoardGamePrices.co.uk and algorithmic recommendations from Recommend.Games, making it a comprehensive MCP server for gaming-related contexts.
- ⭐ 21
- MCP
- kkjdaniel/bgg-mcp
Hive Intelligence MCP Server
Unified MCP server delivering advanced cryptocurrency and Web3 analytics.
Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.
- ⭐ 7
- MCP
- hive-intel/hive-crypto-mcp
Blockchain MCP powered by Tatum
MCP server for universal blockchain data access across 130+ networks.
Blockchain MCP powered by Tatum is a Model Context Protocol (MCP) server that enables large language models (LLMs) to read and write blockchain data across more than 130 networks. It provides unified access to both the Tatum Blockchain Data API and direct RPC gateways, supporting tools for retrieving balances, portfolios, transactions, and more. The platform is designed for seamless integration via API key and configurable MCP client setups, making it easier to build blockchain-aware AI solutions. Comprehensive documentation and extensive network compatibility facilitate robust development and scalability.
- ⭐ 12
- MCP
- tatumio/blockchain-mcp
Didn't find tool you were looking for?