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 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
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인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
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]" ] } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 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