BitPin MCP Server (bitpin-mcp)
An official Model Context Protocol (MCP) server for the BitPin Iranian Cryptocurrency Exchange API (docs.bitpin.ir), built with the official @modelcontextprotocol/typescript-sdk.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add bitpin-mcp -- npx -y bitpin-mcp@1.0.0在終端機中執行。
{ "mcpServers": { "bitpin-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
bitpin-mcp)An official Model Context Protocol (MCP) server for the BitPin Iranian Cryptocurrency Exchange API (docs.bitpin.ir), built with the official @modelcontextprotocol/typescript-sdk.
Model Context Protocol (MCP) server for BitPin Iranian Cryptocurrency Exchange API
This MCP server connects AI assistants (Claude Desktop, Cursor, Antigravity IDE, Cline, Roo Code, etc.) directly to BitPin, allowing users to inspect market prices, monitor orderbooks, place and cancel trading orders, view wallet balances, and manage deposits and withdrawals in real time.
stdio transport, compatible with all major MCP clients.بیت کوین, تتر, اتریوم, ترون, دوج کوین, تومان, سولانا, نات کوین, etc.بیت کوین به تومان, تتر تومان, اتریوم تتر, etc.خرید (buy), فروش (sell).محدود (limit), بازار / فوری (market), استاپ لیمیت (stop_limit), دوطرفه (oco).۰۱۲۳۴۵۶۷۸۹ to standard numbers.فعال (active), بسته (closed), اولیه (initial).npx)You can run the server directly using npx:
npx -y bitpin-mcp
Add the following to your claude_desktop_config.json:
%APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"bitpin": {
"command": "npx",
"args": ["-y", "bitpin-mcp"],
"env": {
"BITPIN_API_KEY": "YOUR_BITPIN_API_KEY",
"BITPIN_SECRET_KEY": "YOUR_BITPIN_SECRET_KEY"
}
}
}
}
Note: If you only need public market data (prices, tickers, orderbook), you can omit the
envblock.
.cursor/mcp.json)Add the server to .cursor/mcp.json in your project or global Cursor settings:
{
"mcpServers": {
"bitpin": {
"command": "npx",
"args": ["-y", "bitpin-mcp"],
"env": {
"BITPIN_API_KEY": "YOUR_BITPIN_API_KEY",
"BITPIN_SECRET_KEY": "YOUR_BITPIN_SECRET_KEY"
}
}
}
}
{
"bitpin": {
"command": "npx",
"args": ["-y", "bitpin-mcp"],
"env": {
"BITPIN_API_KEY": "YOUR_BITPIN_API_KEY",
"BITPIN_SECRET_KEY": "YOUR_BITPIN_SECRET_KEY"
}
}
}
[!WARNING] IP Whitelisting & HTTP 403 Forbidden Notice: BitPin enforces strict IP whitelisting for all API tokens in their Token Manager. When creating your API key pair on BitPin, you must specify the exact IP addresses authorized to access the API. Calling authenticated tools from any IP that is not predefined in BitPin's Token Manager (for instance, when connected to a VPN, a dynamic mobile network, or an unregistered server) will immediately result in an
HTTP 403 Forbiddenerror. If you encounter HTTP 403 errors, check your current public IP (e.g. viacurl ifconfig.me) and add it to your API Key whitelist in the BitPin panel. Public market data tools do not require IP whitelisting.
The server automatically handles Persian names, words, and numbers:
// Query price of Bitcoin in Toman:
bitpin_get_tickers({ symbol: "بیت کوین به تومان" }); // Resolves to BTC_IRT
// Query Tether price:
bitpin_get_tickers({ symbol: "تتر" }); // Resolves to USDT_IRT
// Place a limit buy order:
bitpin_place_order({
symbol: "تتر به تومان", // USDT_IRT
side: "خرید", // buy
type: "محدود", // limit
price: "۵۸۵۰۰", // 58500
base_amount: "۱۰۰" // 100
});
// Filter active orders:
bitpin_get_orders({
symbol: "بیت کوین",
state: "فعال" // active
});
npm install
npm run build
npm start
# or development with live reload:
npm run dev
npm login
npm publish --access public
Once published to npm, anyone can run it immediately with:
npx -y bitpin-mcp
Model Context Protocol (MCP) server for BitPin Iranian Cryptocurrency Exchange API
{ "mcpServers": { "bitpin-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Bitpin 透過 stdio 在本機執行。
上次檢查時間:2026-11-19。 Model Context Protocol (MCP) server for BitPin Iranian Cryptocurrency Exchange API