{"_id":"@braynexservices/nigeria-mcp-quidax-crypto","_rev":"2-f0c6a090a76f733d56e694e1383ad5e8","name":"@braynexservices/nigeria-mcp-quidax-crypto","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@braynexservices/nigeria-mcp-quidax-crypto","version":"0.1.0","keywords":["mcp","model-context-protocol","nigeria","crypto","quidax","naira","ngn","bitcoin","ticker"],"author":{"url":"Braynex Services Ltd — https://www.braynexservices.com","name":"Samuel Orie","email":"braynexservices@gmail.com"},"license":"MIT","_id":"@braynexservices/nigeria-mcp-quidax-crypto@0.1.0","maintainers":[{"name":"braynexservices","email":"braynexservices@gmail.com"}],"homepage":"https://www.braynexservices.com","bugs":{"url":"https://github.com/braynexservices/nigeria-mcp/issues"},"bin":{"nigeria-mcp-quidax-crypto":"dist/stdio.js"},"dist":{"shasum":"39bc0ef497257fa125c5cd3e81289ec6714ff2b2","tarball":"https://registry.npmjs.org/@braynexservices/nigeria-mcp-quidax-crypto/-/nigeria-mcp-quidax-crypto-0.1.0.tgz","fileCount":28,"integrity":"sha512-TApxwTJor4Ei2mmzk+cUO0WEXvnGZ+u/8pfpwDSbJOUbh0wgBaTc6WNjIjmXfvxGD0SQvRvWjFdhMcI3VHWrRQ==","signatures":[{"sig":"MEQCIHTgl9VCehbvx1yi8q3po8jzn12d9A0qsEnBQFxOKsxrAiBLaTFlhez/lb8Nc3swofII5sLbxGGb5ufvyEzfDjBiwQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30996},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"a212543133ceacfdf5cbe48ba7be915222c9c004","mcpName":"io.github.Braynexservices/nigeria-quidax-crypto","private":false,"scripts":{"build":"tsc","smoke":"tsx scripts/smoke.ts","prepack":"tsc","smoke:live":"tsx scripts/live.ts","start:stdio":"tsx src/stdio.ts"},"_npmUser":{"name":"braynexservices","email":"braynexservices@gmail.com"},"repository":{"url":"git+https://github.com/braynexservices/nigeria-mcp.git","type":"git","directory":"lanes/quidax-crypto"},"_npmVersion":"11.6.1","description":"Live crypto tickers in Naira (BTC/NGN, ETH/NGN, USDT/NGN, and more) from the Nigerian exchange Quidax, as read-only MCP tools. Public market data, keyless, no trading.","directories":{},"displayName":"Nigeria Quidax Crypto MCP","_nodeVersion":"24.11.0","dependencies":{"zod":"^3.25.76","@braynexservices/nigeria-mcp-core":"^0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_npmOperationalInternal":{"tmp":"tmp/nigeria-mcp-quidax-crypto_0.1.0_1784437926524_0.6083171244738865","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@braynexservices/nigeria-mcp-quidax-crypto","displayName":"Nigeria Quidax Crypto MCP","version":"0.1.1","description":"Live crypto tickers in Naira (BTC/NGN, ETH/NGN, USDT/NGN, and more) from the Nigerian exchange Quidax, as read-only MCP tools. Public market data, keyless, no trading.","homepage":"https://www.braynexservices.com","repository":{"type":"git","url":"git+https://github.com/braynexservices/nigeria-mcp.git","directory":"lanes/quidax-crypto"},"bugs":{"url":"https://github.com/braynexservices/nigeria-mcp/issues"},"keywords":["mcp","model-context-protocol","nigeria","crypto","quidax","naira","ngn","bitcoin","ticker"],"private":false,"publishConfig":{"access":"public"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","scripts":{"build":"tsc","prepack":"tsc","start:stdio":"tsx src/stdio.ts","smoke":"tsx scripts/smoke.ts","smoke:live":"tsx scripts/live.ts"},"dependencies":{"@braynexservices/nigeria-mcp-core":"^0.3.0","zod":"^3.25.76"},"devDependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"license":"MIT","author":{"name":"Samuel Orie","email":"braynexservices@gmail.com","url":"Braynex Services Ltd — https://www.braynexservices.com"},"engines":{"node":">=20"},"bin":{"nigeria-mcp-quidax-crypto":"dist/stdio.js"},"mcpName":"io.github.Braynexservices/nigeria-quidax-crypto","gitHead":"d90447b167e5d8821ca45aea6970f958fafae28e","_id":"@braynexservices/nigeria-mcp-quidax-crypto@0.1.1","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-/B3jYVGjXHUwuXihPV7+9MKgBzyD2oC9RW5eIsmBxUHINZF+6cUxTsZJ7lFVvF2ThHgnuiLmKw/uc5Bft5VBXw==","shasum":"d72d8e46828b9eacfc87e25bef2d7452630d5eca","tarball":"https://registry.npmjs.org/@braynexservices/nigeria-mcp-quidax-crypto/-/nigeria-mcp-quidax-crypto-0.1.1.tgz","fileCount":28,"unpackedSize":31037,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIE4zn+P0UsIsMEJ6AOpYcXeYETtYogt6fCrC8qjrDB5eAiAPzNhXJLzFB/uVmxArK0bb/fkygoIf1WitAvd2yzoS3g=="}]},"_npmUser":{"name":"braynexservices","email":"braynexservices@gmail.com"},"directories":{},"maintainers":[{"name":"braynexservices","email":"braynexservices@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nigeria-mcp-quidax-crypto_0.1.1_1784464135297_0.143758865474223"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-19T05:12:06.369Z","modified":"2026-07-19T12:28:55.612Z","0.1.0":"2026-07-19T05:12:06.705Z","0.1.1":"2026-07-19T12:28:55.469Z"},"bugs":{"url":"https://github.com/braynexservices/nigeria-mcp/issues"},"author":{"name":"Samuel Orie","email":"braynexservices@gmail.com","url":"Braynex Services Ltd — https://www.braynexservices.com"},"license":"MIT","homepage":"https://www.braynexservices.com","keywords":["mcp","model-context-protocol","nigeria","crypto","quidax","naira","ngn","bitcoin","ticker"],"repository":{"type":"git","url":"git+https://github.com/braynexservices/nigeria-mcp.git","directory":"lanes/quidax-crypto"},"description":"Live crypto tickers in Naira (BTC/NGN, ETH/NGN, USDT/NGN, and more) from the Nigerian exchange Quidax, as read-only MCP tools. Public market data, keyless, no trading.","maintainers":[{"name":"braynexservices","email":"braynexservices@gmail.com"}],"readme":"# Nigeria Quidax Crypto MCP\n\n> Crypto market tickers in Naira (BTC/NGN, ETH/NGN, USDT/NGN, …) from the Nigerian exchange Quidax, exposed to AI agents as MCP tools.\n\n**Status:** 🌐 **Live market data + free (no API key)** · read-only\n**Package:** `@braynexservices/nigeria-mcp-quidax-crypto` v0.1.0 · depends on `@braynexservices/nigeria-mcp-core`\n**Author:** Samuel Orie (Founder) · **Owner:** [Braynex Services Ltd](https://www.braynexservices.com) · **License:** [MIT](./LICENSE)\n**© 2026 Braynex Services Ltd** — MIT licensed (copyright retained; see the [`NOTICE`](./NOTICE)).\n\n---\n\n## What it does\nReturns live crypto tickers for market pairs listed on **[Quidax](https://quidax.io)**, a Nigerian exchange — the last traded price plus 24h high/low/volume, priced in the quote currency (e.g. `btcngn` = NGN per 1 BTC). Data comes from Quidax's public market-data API — **keyless** and **read-only** (no account, no orders, no trading). Public market data — no PII.\n\n## Tools\n\n### `get_crypto_ticker`\nLatest ticker for one market pair.\n\n| Param | Required | Notes |\n|---|---|---|\n| `market` | ✅ | Market pair id, lowercase, min 5 chars (e.g. `btcngn`, `ethngn`, `usdtngn`). Get valid ids from `list_crypto_markets`. |\n\n**Example:**\n```jsonc\n// → get_crypto_ticker({ \"market\": \"btcngn\" })\n\"BTC/NGN last 90691052 NGN (as of 2026-07-18T09:06:00.000Z, source: quidax)\"\n// structuredContent: {\n//   market:\"btcngn\", base:\"BTC\", quote:\"NGN\",\n//   last:90691052, high:91686674, low:89489016, volume:0.57144386,\n//   at:\"2026-07-18T09:06:00.000Z\", source:\"quidax\", retrievedAt:\"…\"\n// }\n```\n`high` / `low` / `volume` are `null` when Quidax doesn't report them. The `source` field (`quidax` vs `mock`) is echoed into the text line — see **Limits & notes**.\n\n### `list_crypto_markets`\nAll market pairs available on the exchange, each split into base asset + quote currency. Takes no arguments.\n\n| Param | Required | Notes |\n|---|---|---|\n| _(none)_ | — | No input. |\n\n**Example:**\n```jsonc\n// → list_crypto_markets({})\n\"3 markets: btcngn, ethngn, usdtngn\"\n// structuredContent: {\n//   markets: [\n//     { market:\"btcngn\",  base:\"BTC\",  quote:\"NGN\" },\n//     { market:\"ethngn\",  base:\"ETH\",  quote:\"NGN\" },\n//     { market:\"usdtngn\", base:\"USDT\", quote:\"NGN\" }\n//   ],\n//   count: 3\n// }\n```\n> The mock provider lists the 3 fixture pairs above; the live Quidax provider lists 90+ pairs.\n\n## Configuration — `CRYPTO_PROVIDER`\n\n| Value | Behaviour |\n|---|---|\n| `mock` *(default)* | Offline deterministic fixtures (`btcngn`, `ethngn`, `usdtngn`) — **synthetic prices**, for dev/eval |\n| `quidax` | **Live** tickers from Quidax's public market-data API (keyless). Set this for real prices. |\n\nNo API key required.\n\n## Run it\n\n```bash\nnpm install && npm run build      # from repo root\n\nnpm run smoke      -w @braynexservices/nigeria-mcp-quidax-crypto   # offline (mock)\nnpm run smoke:live -w @braynexservices/nigeria-mcp-quidax-crypto   # live (real Quidax API)\n\nCRYPTO_PROVIDER=quidax npm run start:stdio -w @braynexservices/nigeria-mcp-quidax-crypto   # serve over stdio, live\n```\n\n**MCP Inspector** (interactive GUI):\n```bash\nCRYPTO_PROVIDER=quidax npx @modelcontextprotocol/inspector node lanes/quidax-crypto/dist/stdio.js\n```\n\n**Claude Desktop / Code** — add to your MCP config (needs Node.js ≥ 20):\n```json\n{\n  \"mcpServers\": {\n    \"nigeria-quidax-crypto\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@braynexservices/nigeria-mcp-quidax-crypto\"],\n      \"env\": { \"CRYPTO_PROVIDER\": \"quidax\" }\n    }\n  }\n}\n```\nRunning from a clone instead: `\"command\": \"node\", \"args\": [\"/path/to/nigeria-mcp/lanes/quidax-crypto/dist/stdio.js\"]`. Then ask, e.g., *\"What's the BTC to naira price on Quidax right now?\"*\n\n## Limits & notes\n- **Default provider is `mock` → SYNTHETIC prices, not the live market.** With `CRYPTO_PROVIDER` unset (or `mock`), the tools return deterministic fixture prices — useful for dev/eval, **not** real quotes. Every result carries its origin: the text line ends with `source: mock` vs `source: quidax`, and `structuredContent.source` says the same. So a synthetic price can never be mistaken for a live quote. **Set `CRYPTO_PROVIDER=quidax` for real prices.**\n- **Informational, not trading advice.** These are read-only market tickers. No orders, positions, or account access — this lane cannot trade.\n- **Live source is Quidax public market data** (`https://app.quidax.io/api/v1`), keyless. 15s fetch timeout; unknown pairs return an actionable \"not found\" (call `list_crypto_markets`), transient failures suggest `CRYPTO_PROVIDER=mock`.\n- **Numbers:** prices/volume are numeric; `high`/`low`/`volume` may be `null` when the exchange omits them. `at` is the ISO-8601 ticker snapshot time; `retrievedAt` is when this server fetched it.\n\n## Verification\n`npm run verify` (repo root) → build + all lane smokes + eval. This lane: offline smoke (mock, `btcngn` pinned) + `smoke:live` against the real Quidax API, independent code-review (string-encoded prices parsed, `source` surfaced in text so mock is never passed off as live).\n","readmeFilename":"README.md"}