io.github.mohammad-abbasi-sh/paribu-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.mohammad-abbasi-sh/paribu-mcp What's the current BTC/TL price and 24h change on Paribu?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
paribu-mcp πΉπ·
mcp-name: io.github.mohammad-abbasi-sh/paribu-mcp
Unofficial read-only MCP server for Paribu (paribu.com), TΓΌrkiye's largest crypto exchange β live 24h tickers for 266 markets (BTC, ETH and 190+ coins vs TL and USDT), order books with spread and mid price, recent trades, the full 467-market catalogue, and currency metadata with networks and withdrawal fees.
Part of the "Turkey MCP factory". Not affiliated with Paribu. Data comes from Paribu's official public API (
api.paribu.com, docs atdocs.paribu.com/api) β no login, no API key, read-only.
For AI agents
Market ids are lowercase
base_quote, e.g.btc_tlβ the Turkish lira quote is spelledtl, nottry.Ticker:
paribu_get_tickerwith a market returns one 24h snapshot; without a market it returns a ranked list (default sort: pair volume). 266 markets have live tickers; the config lists 467 pairs (some are OTC-only or not yet trading).Order book:
paribu_get_orderbookreturns best bid/ask, spread, mid price and the levels. An unknown market answers with an error β Paribu itself returns HTTP 200 with a null body for it.Trades:
paribu_get_recent_tradesβ limit 1β20 (the API maximum), newest first.Catalogue:
paribu_list_marketslists all 467 pairs with price/amount precision and steps;paribu_get_currencyreturns a currency's networks, deposit/withdrawal limits and per-network withdrawal fees.Movers:
paribu_market_moversranks the top gainers/losers by 24h percentage.Every response carries
fetched_at(UTC) andsource: api.paribu.com.
Related MCP server: mcp-bitfinex
Install
uvx paribu-mcpOr add to your MCP client config (e.g. Claude Desktop):
{
"mcpServers": {
"paribu": {
"command": "uvx",
"args": ["paribu-mcp"]
}
}
}Tools
Tool | What it does |
| 24h ticker for one market, or a ranked list of all 266 markets (filter by |
| Live order book: best bid/ask, spread, mid price, levels (1β100 per side) |
| Most recent public trades, newest first (1β20) |
| Full 467-pair catalogue with precision, steps, labels, OTC flag |
| Currency metadata: networks, arrival times, explorers, withdrawal fees, limits |
| Top gainers / losers over the last 24h |
| Is the Paribu public API reachable right now? |
Example
{ "market": "btc_tl", "last": 3252946.0, "low": 3246001.0, "high": 3344137.0,
"change": -84957.0, "percentage": -2.54, "volume": 32.147208,
"pair_volume": 106109641.0 }Caveats
Prices are live market data, not investment advice β verify on paribu.com before acting on them.
An unknown market id on the ticker endpoint returns HTTP 500 with code
5001; on the order book it returns HTTP 200 with a null body.The config endpoint is polled at most once per call; Paribu recommends polling it no more than every 60 seconds.
Transport uses Chrome TLS impersonation with a plain-requests fallback; requests are spaced ~0.5s apart.
Development
python -m venv .venv && .venv/bin/pip install -e ".[dev]" # or: pip install -e . pytest
.venv/bin/python -m pytest tests/test_markets.py -v # offline, recorded fixtures
.venv/bin/python -m pytest tests/test_live.py -v # live, against api.paribu.com
.venv/bin/python tests/smoke_live.py # daily CI probeBuilt by Mohammad Abbasi β Almanibama Β· mabbasi.ir
Available Tools
7 toolsparibu_get_currencyA
Currency metadata from the exchange config: name, type, precision/step, listing date, deposit and withdrawal limits, and per-network details (name, estimated arrival, explorer link, withdrawal fee). currency: e.g. "btc", "eth", "usdt", "xrp".
Inputs: currency (required). Returns: result
paribu_get_orderbookA
Live order book for one market: best bid/ask, spread, mid price and the price levels on each side. market: e.g. "btc_tl". limit 1..100 price levels per side (default 20).
Inputs: market (required), limit. Returns: result
paribu_get_recent_tradesA
Most recent public trades for one market, newest first. market: e.g. "btc_tl". limit 1..20 (the API maximum).
Inputs: market (required), limit. Returns: result
paribu_get_tickerA
24h ticker snapshot(s) from Paribu. market: one market id, e.g. "btc_tl" (omit for a ranked list of all 266 markets). quote: filter the list to "tl" or "usdt" (ignored when market is given). limit 1..266. sort: "pair_volume" (default), "percentage", "volume", "change" or "last" β descending. Returns last/first/low/high/average price, 24h change and percentage, base volume and pair (quote) volume.
Inputs: sort, limit, quote, market. Returns: result
paribu_healthA
Check whether Paribu's public API is reachable right now.
Returns status ok (HTTP 200), blocked (HTTP 403/429 β bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings.
Inputs: no named parameters. Returns: result
paribu_list_marketsA
The full Paribu market catalogue from the exchange config: 467 pairs with base/quote, price and amount precision and steps, labels and the OTC-only flag. quote: filter to "tl" or "usdt" (omit for all). limit 1..467.
Inputs: limit, quote. Returns: result
paribu_market_moversA
Top gainers or losers on Paribu over the last 24h, ranked by percentage change. direction: "gainers" (default) or "losers". quote: filter to "tl" or "usdt" (omit for all). limit 1..50.
Inputs: limit, quote, direction. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 7 tools
Each tool targets a distinct data shape: snapshot ticker, live order book, recent trades, market catalogue, currency metadata, movers, health. The only real overlap is between paribu_get_ticker (which can sort by 'percentage'/'change' across all markets) and paribu_market_movers (ranked gainers/losers), which an agent could plausibly pick the wrong one for.
A clear 'paribu_' namespace plus verb_noun convention (get_ticker, get_orderbook, get_recent_trades, list_markets, get_currency) is followed for most tools. Two outliers β paribu_market_movers and paribu_health β drop the verb, a minor deviation that stays readable.
Seven tools is well within the ideal range and each covers a distinct slice of a read-only exchange data API. Nothing feels padded or redundant.
The surface covers the core public market-data lifecycle: discovery (list_markets, get_currency), pricing (ticker, orderbook), activity (recent_trades, movers) and availability (health). The notable gap is historical/OHLC candlestick data, which agents would expect from an exchange data server but must work around.
Maintenance
Related MCP Connectors
Real-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.
Read-only crypto, equities, FX and commodities market data. No trading tools. API key required.
Read-only market charts, OHLC, backtests and a view of your connected broker accounts
Read-only educational MCP for CryptoDecentral Sovereign. No auth, trading, custody, or advice.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables access to financial market data including EOD, intraday, fundamentals, news, and more via 75 read-only MCP tools.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables access to Bitfinex v2 public market data including ticker history, trades, orderbook, stats, candles, derivatives status, and liquidations via MCP tools, with plain English querying support.106 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to Hyperliquid's public market, user, vault, and staking data via 61 MCP tools, covering perpetuals, spot, and borrow-lend information.MIT
- AlicenseBqualityBmaintenanceEnables credential-free, read-only access to selected public market-data routes via 13 typed MCP tools covering asset mapping, metadata, quotes, listings, global metrics, Fear & Greed, Altcoin Season, and CMC index data.13MIT