Repository navigation
Getting Started
- Python 3.10 – 3.13
- No API keys, no database, no external services
Install uv and run the Python distribution directly:
uvx tapebasis --helpWith Node.js 18 or newer, the npm launcher runs that same uvx tapebasis command:
npx tapebasis --helpThe launcher has no runtime dependencies of its own, forwards arguments and environment, and works over stdio. Set TAPEBASIS_UVX if uvx is not on the client's PATH. It prints an installation link when uv is missing. On Windows it invokes an executable directly, without a command shell.
The v1.0.0 wheel, sdist and npm launcher are published. pip install tapebasis and uvx tapebasis work directly. GHCR serves the 1.0.0 image for linux/amd64 and linux/arm64. MCP Registry metadata is still being recovered from a partial release and will appear once the protected recovery workflow completes.
git clone https://github.com/giraygokirmak/tapebasis.git
cd tapebasis
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -e .Verify:
tapebasis --help
python -c "from tapebasis import server; print('ok')"stdio is the default transport. The client spawns the process and talks over stdin/stdout.
Alternatively, use "command": "uvx", "args": ["tapebasis"], or the absolute path to the checkout's tapebasis executable. npx and uvx must be available in the client process's PATH; some GUI clients do not inherit your shell's PATH.
tapebasis streamable-http --host 0.0.0.0 --port 8000| Flag | Env fallback | Default |
|---|---|---|
--host |
HOST |
127.0.0.1 |
--port |
PORT |
8000 |
Endpoints:
-
POST/GET /mcp: the MCP streamable-HTTP endpoint -
GET /health: cached health verdict plus per-provider rate-limit state, no upstream call (safe for container healthchecks)
curl -s localhost:8000/health | python -m json.toolBind to 127.0.0.1 unless you are behind a private network. The server has no authentication of its
own.
stock_quote("AAPL") # every provider that carries it
stock_quote("XAUUSD") # gold: TradingView and Bloomberg, the rest not carried
market_indices() # S&P 500, Dow, Nasdaq, Russell 2000, VIX
stock_news("NVDA")
market_sentiment("TSLA") # works with no API key
tapebasis_health() # upstream drift/outage + rate-limit state
tapebasis_tool_map() # what is multi-sourced, before calling anything
{
"data_provider": "ALL",
"verification": "MULTI_SOURCE",
"providers_answered": ["TRADINGVIEW", "FINVIZ", "YAHOO", "SA", "BLOOMBERG"],
"notice": "Every provider asked answered (TradingView, Finviz, Yahoo Finance, StockAnalysis and Bloomberg). Coverage is ALL; agreement is a separate axis. Compared fields agree within tolerance. The value shown is FINVIZ's because it printed more recently than the other providers'.",
"data": { "price": 332.33, "previous_close": 331.9, ... },
"fields": {
"price": { "source": "FINVIZ", "compared": ["TRADINGVIEW", "FINVIZ", "YAHOO", "SA"], "agreement": true },
"peers": { "source": "FINVIZ", "compared": ["FINVIZ"], "agreement": null }
},
"freshness": {
"tradingview": "2026-11-04T00:59:53+00:00",
"finviz": "2026-11-04T10:42:00+00:00",
"yahoo": "2026-11-03T21:00:01+00:00",
"sa": "2026-11-03T21:00:01+00:00",
"bloomberg": "2026-11-04T10:27:00+00:00",
"chosen": "FINVIZ",
"decision": "newest",
"newest_print": "2026-11-04T10:42:00+00:00"
},
"comparisons": [
{ "field": "price", "match": true,
"values": { "TRADINGVIEW": 331.9, "FINVIZ": 332.33, "YAHOO": 331.9, "SA": 331.9, "BLOOMBERG": 332.1 },
"diff_pct": 0.1294 }
],
"resolutions": {
"TRADINGVIEW": { "symbol": "NASDAQ:AAPL", "method": "search" },
"FINVIZ": { "symbol": "AAPL", "method": "normalise" },
"YAHOO": { "symbol": "AAPL", "method": "alias" },
"SA": { "symbol": "aapl", "method": "mechanical" },
"BLOOMBERG": { "symbol": "AAPL:US", "method": "mechanical" }
},
"warnings": [
"Not cross-checked (no shared basis for comparison): change_percent, previous_close, volume"
],
"degraded": false
}Five things to notice:
-
data_providerisALLandproviders_answerednames every provider that answered. -
data.priceis one number.freshnessexplains where it came from: Finviz printed at10:42Z, TradingView at00:59:53Z, Yahoo and StockAnalysis at21:00:01Z, so the newest reading won. Every raw price is still incomparisons. -
fieldsshowsprice.sourceis FINVIZ, the freshest print, cross-checked against four providers that agreed (compared), whilepeerscame from Finviz alone. Per-field provenance, not a blanket claim: a value is never labelled as a joint product of several providers. - The
warningsentry is not an error: Finviz is mid-session while the others are at the prior close, so the session-relative fields (day change, previous close, volume) were not compared. Reporting that is more honest than calling it a conflict, or silently implying agreement. -
resolutionsshows the ticker each provider was asked for. This is where a symbol surprise becomes explicable. If that symbol was resolved but a provider returned nothing, its error staysNO_DATA; it is not turned intoNOT_ATTEMPTED.
The positive Compared fields agree within tolerance notice requires an actual agreeing pair.
Unusable pairs stay visible with match: null and a not_comparable reason. If no comparison can
reach a verdict, the notice states that instead of implying agreement.
If data_provider were TRADINGVIEW, FINVIZ, YAHOO, SA or BLOOMBERG, the notice would say the data
is not corroborated and an agent must relay that. A BLOOMBERG label is worth one extra check:
its equity and index quotes are exchange-delayed, so exchange_delay and print_time travel with the
payload and decide whether the number can be called live.
stock_quote("XAUUSD")
{
"data_provider": "ALL",
"verification": "MULTI_SOURCE",
"providers_answered": ["TRADINGVIEW", "BLOOMBERG"],
"notice": "Every provider asked answered (TradingView and Bloomberg). ...",
"data": { "price": 4042.04, ... },
"comparisons": [
{ "field": "price", "match": true,
"values": { "TRADINGVIEW": 4042.04, "BLOOMBERG": 4041.87 }, "diff_pct": 0.0042 }
],
"resolutions": {
"TRADINGVIEW": { "symbol": "OANDA:XAUUSD", "method": "alias" },
"FINVIZ": { "symbol": null, "note": "Finviz carries US equities/ETFs only" },
"YAHOO": { "symbol": null, "note": "Yahoo Finance has no spot gold pair; its nearest series is COMEX gold futures (GC=F), a different instrument, not substituted." },
"SA": { "symbol": null, "note": "StockAnalysis's quote API carries US equities and ETFs only" },
"BLOOMBERG": { "symbol": "XAUUSD:CUR", "method": "alias" }
},
"errors": []
}Gold is a good demonstration of the rules: three providers do not carry spot gold, and errors stays
empty because none of them failed. Yahoo's note refuses to substitute a futures contract for a spot
pair: a different instrument at a different price is not the same quote. The two that do carry it,
TradingView and Bloomberg, are ALL with both readings in comparisons. If Bloomberg's page is
blocked or times out, the same call degrades to TRADINGVIEW / SINGLE_SOURCE and the notice says
the value is not corroborated.
bloomberg_markets()
{
"data_provider": "BLOOMBERG",
"verification": "SINGLE_SOURCE",
"providers_answered": ["BLOOMBERG"],
"cross_checked": false,
"reconciliation_leg": false,
"print_time": null,
"data": {
"government_yields": [
{ "symbol": "GT10:GOV", "name": "US 10 Yr", "price": 4.8777106, "change_percent": -0.0102 }
],
"indices": [ { "symbol": "SPX:IND", "name": "S&P 500", "price": 7688.62 } ],
"commodities": [ ... ],
"fx": [ ... ]
},
"warnings": [ "Bloomberg's market board carries no per-instrument print time ..." ]
}This tool asks one provider, so the payload is single-source by construction. The provider itself is
not: stock_quote asks Bloomberg in parallel with every other provider, and its reading appears in
comparisons. There its declared 15-minute delay is handled openly: a pair a delay length apart is
reported as not_comparable with the reason, and a delayed page never wins a freshness tie. The
government benchmark curve is the capability no other provider here publishes, which is why the
provider is worth asking at all. Access needs curl_cffi, which pip install -e . brings in:
bloomberg.com rejects plain HTTP clients on the TLS fingerprint.
- Response Contract: every field explained
- Tools Reference: all 35 tools
- Configuration: environment variables
- Docker: prebuilt GHCR image or a local build