{"_id":"@barfinex/provider-mcp","_rev":"5-0c1fb02c0cbaaa02e78c27a9158dc1dd","name":"@barfinex/provider-mcp","dist-tags":{"latest":"1.0.4"},"versions":{"1.0.0":{"name":"@barfinex/provider-mcp","version":"1.0.0","author":{"name":"Barfinex"},"license":"MIT","_id":"@barfinex/provider-mcp@1.0.0","maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"dist":{"shasum":"d574b45f7910c5140acfa8b2c4bcf7b53593eee8","tarball":"https://registry.npmjs.org/@barfinex/provider-mcp/-/provider-mcp-1.0.0.tgz","fileCount":10,"integrity":"sha512-dJ0FNA7k3bH/2SLcI9QBZjaSiZI3h7tCJdLDLiLigj9yFOVJ/2Bcq0falMUEg+eEzjdx5Ci5bmqrLhpJJLegaw==","signatures":[{"sig":"MEUCIQCPevh7TUmhM/qNbD/XQISc85fIWiX/ANmU/j8NbMZwBAIgU8L1zXdzsJgguERQetnwNNqYgRljaSyNxXnbFgWOS+8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46176},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"e83874c796c74d8709402c3d9852cf3e221cef06","private":false,"scripts":{"build":"tsc -p tsconfig.app.json","clean":"rimraf dist tsconfig.tsbuildinfo","rebuild":"npm run clean && npm run build","prebuild":"node ../../tools/hygiene/clean-compiled-in-src.js","build:npm":"tsc -p tsconfig.build.json","postbuild":"node ../../tools/hygiene/verify-no-compiled-in-src.js","prebuild:npm":"node ../../tools/hygiene/clean-compiled-in-src.js","postbuild:npm":"node ../../tools/hygiene/verify-no-compiled-in-src.js"},"_npmUser":{"name":"vvsur","email":"info@barfin.org"},"buildDate":"2026-03-26T14:00:00","_npmVersion":"10.8.2","description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.1","dependencies":{"zod":"^4.1.8","axios":"^1.6.8","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.6.3","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/provider-mcp_1.0.0_1774512297009_0.3288264898068296","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@barfinex/provider-mcp","version":"1.0.1","author":{"name":"Barfinex"},"license":"MIT","_id":"@barfinex/provider-mcp@1.0.1","maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"dist":{"shasum":"00b409559cb65384cb4fb0f2d98a495bb79076f2","tarball":"https://registry.npmjs.org/@barfinex/provider-mcp/-/provider-mcp-1.0.1.tgz","fileCount":10,"integrity":"sha512-+SxfBFnQ5SNdQCpHG+qkSdgC1RrQXBLz/9X4b/oTpL7tMEEr69tIF/VkklQqsyfx3LGZUWXmH88uwSDy0lM3og==","signatures":[{"sig":"MEUCIEaJxuIaGq+JKucWoASinwt5DbugafhD6u+RfVNIdjOYAiEAtbGIO0InYErMjGmfUqgx7VJ237ScIb1jXAeWVZPZQpY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46176},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"e1cde73a0e76ca5ebc5efe4cc837347d398b8ea8","private":false,"scripts":{"build":"tsc -p tsconfig.app.json","clean":"rimraf dist tsconfig.tsbuildinfo","rebuild":"npm run clean && npm run build","prebuild":"node ../../tools/hygiene/clean-compiled-in-src.js","build:npm":"tsc -p tsconfig.build.json","postbuild":"node ../../tools/hygiene/verify-no-compiled-in-src.js","prebuild:npm":"node ../../tools/hygiene/clean-compiled-in-src.js","postbuild:npm":"node ../../tools/hygiene/verify-no-compiled-in-src.js"},"_npmUser":{"name":"vvsur","email":"info@barfin.org"},"buildDate":"2026-03-26T15:00:00","_npmVersion":"10.8.2","description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.1","dependencies":{"zod":"^4.1.8","axios":"^1.6.8","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.6.3","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/provider-mcp_1.0.1_1774512908116_0.6682041386292539","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@barfinex/provider-mcp","version":"1.0.2","author":{"name":"Barfinex"},"license":"MIT","_id":"@barfinex/provider-mcp@1.0.2","maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"dist":{"shasum":"818314e9770cc3d29ca4461cc61daa0cfb95e835","tarball":"https://registry.npmjs.org/@barfinex/provider-mcp/-/provider-mcp-1.0.2.tgz","fileCount":10,"integrity":"sha512-trtCgswWpnx54RZJMnI1zRfhGMiH9QAdhD3WF/dPjmGvh3UgDibV2ZzxIV38bfGdvQXMSEd7ZFWAslgSHDIAyw==","signatures":[{"sig":"MEQCID9Owuvfj2WQqHhKYh9vh32lpshd/Ae3XbCBNtvmb7DQAiBd5nMB/2DGOHu49Na+F63Sxd1JWgxdSGs+GIw9Tr6ttg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46176},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"44b91e818f5417a9a95f216a121370737cffcddf","private":false,"scripts":{"build":"tsc -p tsconfig.app.json","clean":"rimraf dist tsconfig.tsbuildinfo","rebuild":"npm run clean && npm run build","prebuild":"node ../../tools/hygiene/clean-compiled-in-src.js","build:npm":"tsc -p tsconfig.build.json","postbuild":"node ../../tools/hygiene/verify-no-compiled-in-src.js","prebuild:npm":"node ../../tools/hygiene/clean-compiled-in-src.js","postbuild:npm":"node ../../tools/hygiene/verify-no-compiled-in-src.js"},"_npmUser":{"name":"vvsur","email":"info@barfin.org"},"buildDate":"2026-03-26T16:00:00","_npmVersion":"10.8.2","description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.1","dependencies":{"zod":"^4.1.8","axios":"^1.6.8","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.6.3","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/provider-mcp_1.0.2_1774512930985_0.791352492215424","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@barfinex/provider-mcp","version":"1.0.3","author":{"name":"Barfinex"},"license":"MIT","_id":"@barfinex/provider-mcp@1.0.3","maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"dist":{"shasum":"e99e6439b8156cbc8f84481e29ebd7bc33e0d284","tarball":"https://registry.npmjs.org/@barfinex/provider-mcp/-/provider-mcp-1.0.3.tgz","fileCount":10,"integrity":"sha512-AzvlcyPpZ0rjnRhZ+16uWBGRQMYEiTwew9U60ns59gJxOausY8vbL08k8iCX3QFLgolGxeU3ac+ZLEs8xeoQ7g==","signatures":[{"sig":"MEUCIFU9m74fIJnPKya4Eh2H816cXJFyj70cb/w8ZgLdak+0AiEA5hXJOOdbn/7eG1sOCIszJjf3KJx8tKjFZklJpqJ6eWw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46176},"main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"33f06e3eaba499eff0415cc1a6e8eb2e4a0b4332","private":false,"scripts":{"build":"tsc -p tsconfig.app.json","clean":"rimraf dist tsconfig.tsbuildinfo","rebuild":"npm run clean && npm run build","prebuild":"node ../../tools/hygiene/clean-compiled-in-src.js","build:npm":"tsc -p tsconfig.build.json","postbuild":"node ../../tools/hygiene/verify-no-compiled-in-src.js","prebuild:npm":"node ../../tools/hygiene/clean-compiled-in-src.js","postbuild:npm":"node ../../tools/hygiene/verify-no-compiled-in-src.js"},"_npmUser":{"name":"vvsur","email":"info@barfin.org"},"buildDate":"2026-03-26T17:00:00","_npmVersion":"10.8.2","description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","directories":{},"sideEffects":false,"_nodeVersion":"20.20.1","dependencies":{"zod":"^4.1.8","axios":"^1.6.8","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^5.0.5","typescript":"^5.6.3","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/provider-mcp_1.0.3_1774513472354_0.7004220693344096","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@barfinex/provider-mcp","version":"1.0.4","private":false,"description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","author":{"name":"Barfinex"},"license":"MIT","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","require":"./dist/index.js","types":"./dist/index.d.ts"}},"sideEffects":false,"scripts":{"clean":"rimraf dist tsconfig.tsbuildinfo","prebuild":"node ../../tools/hygiene/clean-compiled-in-src.js","build":"tsc -p tsconfig.app.json","postbuild":"node ../../tools/hygiene/verify-no-compiled-in-src.js","prebuild:npm":"node ../../tools/hygiene/clean-compiled-in-src.js","build:npm":"tsc -p tsconfig.build.json","postbuild:npm":"node ../../tools/hygiene/verify-no-compiled-in-src.js","rebuild":"npm run clean && npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","axios":"^1.6.8","zod":"^4.1.8"},"devDependencies":{"@types/node":"^20.11.30","rimraf":"^5.0.5","typescript":"^5.6.3"},"buildDate":"2026-03-26T17:00:00","_id":"@barfinex/provider-mcp@1.0.4","gitHead":"ffe9a3ddb61c13eb342801cd23d430885d1c1ede","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-1HRaa2hPBTNm2Ey9d6SiB20bPa1PW6P5YXtXgCF6iWn6qSolPkuszysh1TgW4pGH0GP4rwkqDx49/+NbEF56uw==","shasum":"b728195057266dded3133c4472837517058cd357","tarball":"https://registry.npmjs.org/@barfinex/provider-mcp/-/provider-mcp-1.0.4.tgz","fileCount":10,"unpackedSize":46176,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD9rZvBKEZ3EQ3jcUHdiWPcaSPwfyx1WGBGw9E2+C3azQIgUMrI1EchMo/MUSY9mQg+YXpgQ596GLgziU1RsSxQlu8="}]},"_npmUser":{"name":"vvsur","email":"info@barfin.org"},"directories":{},"maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/provider-mcp_1.0.4_1774513908225_0.12995188672845637"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-26T08:04:56.881Z","modified":"2026-03-26T08:31:51.272Z","1.0.0":"2026-03-26T08:04:57.181Z","1.0.1":"2026-03-26T08:15:08.262Z","1.0.2":"2026-03-26T08:15:31.116Z","1.0.3":"2026-03-26T08:24:32.511Z","1.0.4":"2026-03-26T08:31:48.360Z"},"author":{"name":"Barfinex"},"license":"MIT","description":"Swagger-driven MCP server bootstrap for Barfinex Provider API.","maintainers":[{"name":"vvsur","email":"info@barfin.org"}],"readme":"# @barfinex/provider-mcp\n\n**MCP (Model Context Protocol) server** that exposes the [Barfinex](https://barfinex.com) Provider API as tools for AI assistants — use Cursor, Claude, or any MCP client to query accounts, orders, candles, detectors, and more without writing HTTP by hand.\n\nThe server is **Swagger-driven**: it fetches the Provider OpenAPI spec and registers one tool per API operation. New Provider endpoints automatically become available as MCP tools.\n\n---\n\n## What it does\n\n- **Static tools** — `provider_health`, `provider_request`, `provider_refresh_openapi_tools`, `provider_openapi` for availability and fallback.\n- **Dynamic tools** — one tool per Provider REST operation (e.g. `provider_getAccounts`, `provider_getCandles`) from OpenAPI.\n- **Stdio transport** — runs as a process; MCP clients connect via stdio (e.g. Cursor MCP config).\n- **Configurable** — `PROVIDER_API_URL`, `PROVIDER_BEARER_TOKEN`, optional `PROVIDER_MCP_INSECURE_TLS` for local HTTPS.\n\n---\n\n## Installation\n\n```sh\nnpm install @barfinex/provider-mcp\n```\n\n---\n\n## Quick use\n\n```ts\nimport { startProviderMcpServer } from '@barfinex/provider-mcp';\n\n// Starts the MCP server (stdio). Typically run by your MCP client, e.g.:\n// \"command\": \"node\", \"args\": [\"path/to/run-mcp.js\"]\nawait startProviderMcpServer();\n```\n\nConfigure your MCP client (e.g. Cursor) with the script that calls `startProviderMcpServer()`, and set `PROVIDER_API_URL` and `PROVIDER_BEARER_TOKEN` in the environment so the server can reach your Provider.\n\n---\n\n## What's included\n\n| Export | Purpose |\n|--------|--------|\n| `startProviderMcpServer()` | Starts the MCP server; uses stdio and loads OpenAPI from Provider. |\n\nEnvironment: `PROVIDER_API_URL`, `PROVIDER_BEARER_TOKEN`, `PROVIDER_MCP_INSECURE_TLS`, `PROVIDER_MCP_TIMEOUT_MS`.\n\n---\n\n## Documentation\n\n- **Provider MCP (AI tools)** — [Using Barfinex with MCP (AI tools)](https://barfinex.com/docs/provider-mcp) — setup, run modes, auth, troubleshooting.\n- **Provider** — [Installation provider](https://barfinex.com/docs/installation-provider), [Provider API reference](https://barfinex.com/docs/provider-api), [Understanding Provider Logs](https://barfinex.com/docs/installation-provider-logs).\n- **Barfinex** — [First Steps](https://barfinex.com/docs/first-steps), [Architecture](https://barfinex.com/docs/architecture), [Typical problems and solutions](https://barfinex.com/docs/troubleshooting).\n\n---\n\n## Contributing\n\nImprovements and feedback welcome. Community: [Telegram](https://t.me/barfinex) · [GitHub](https://github.com/barfinex).\n\n---\n\n## License\n\nLicensed under the [Apache License 2.0](LICENSE) with additional terms. Attribution to **Barfin Network Limited** and a link to [https://barfinex.com](https://barfinex.com) are required. See [LICENSE](LICENSE) and the [Barfinex site](https://barfinex.com) for details.\n","readmeFilename":"README.md"}