BitTuitive
One Lightning payment, any verified data API: highest-rated source, automatic fallback.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (5)
- HIGH
- MEDIUMin get_stock_filings
- LOWin get_feed
- LOWin update_feed
- LOWin get_balance
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"bittuitive": {
"url": "https://api.bittuitive.ai/mcp"
}
}
}Remote-Endpunkte
https://api.bittuitive.ai/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (34)
🟢best_endpoint(need, data_type, protocol, limit)
Free. Find the highest-scoring paid agent API (L402/x402) for a need, e.g. 'bitcoin price', 'weather forecast', 'stock quotes'. Returns up to `limit` ranked endpoints with URL, protocol, price and 0-100 quality score from BitTuitive's own probes.
Eingabe-Schema
{
"type": "object",
"properties": {
"need": {
"type": "string",
"description": "What the API should provide (keywords)."
},
"data_type": {
"type": "string",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"description": "Optional category filter."
},
"protocol": {
"type": "string",
"enum": [
"L402",
"x402"
],
"description": "Optional payment protocol filter."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 3
}
},
"required": [
"need"
]
}🟢scoreboard_search(q, data_type, protocol, min_score, limit, ...)
Free. Search/browse the scoreboard of paid agent APIs with filters; sorted by score.
Eingabe-Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Text search in name, description and URL."
},
"data_type": {
"type": "string",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
]
},
"protocol": {
"type": "string",
"enum": [
"L402",
"x402"
]
},
"min_score": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10
},
"offset": {
"type": "integer",
"minimum": 0,
"default": 0
}
}
}🟢scoreboard_categories(top)
Free. Per data type (bitcoin, crypto, stocks, weather, traffic, other): counts, average score and the top endpoints.
Eingabe-Schema
{
"type": "object",
"properties": {
"top": {
"type": "integer",
"minimum": 0,
"maximum": 10,
"default": 3
}
}
}🟢scoreboard_endpoint(id)
Free. Score components, probe stats and recent probe history for one scoreboard entry (id from best_endpoint/scoreboard_search).
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
]
}🟢bittuitive_pricing
Free. BitTuitive's paid endpoints, per-call prices in sats, subscription plans, and live status.
Eingabe-Schema
{
"type": "object",
"properties": {}
}🟡request_data(data_type, description, example_query, max_price_sats, contact)
Free. Tell BitTuitive what data you want (data_type, description, an example query, and the max price in sats you would pay). This records a demand signal only; it does not add a source or bypass the paywall. New sources need a clearly legal, redistributable origin and an operator go-ahead. Ranked counts are the paid get_market_insights tool; public /api/v1/insights/* pages are teasers only.
Eingabe-Schema
{
"type": "object",
"properties": {
"data_type": {
"type": "string",
"description": "Category, e.g. weather, stocks, traffic, other."
},
"description": {
"type": "string",
"description": "What you need and why it would help."
},
"example_query": {
"type": "string",
"description": "An example query or URL shape you would send."
},
"max_price_sats": {
"type": "integer",
"minimum": 0,
"description": "Max sats you would pay per call."
},
"contact": {
"type": "string",
"description": "Optional email so an operator can follow up. Never published."
}
},
"required": [
"data_type",
"description"
]
}🟢route_endpoints(data_type)
Free. Every scoreboard-verified L402 API the BitTuitive router can call on your behalf right now, grouped by data type, with upstream price, BitTuitive fee and the all-in price in sats.
Eingabe-Schema
{
"type": "object",
"properties": {
"data_type": {
"type": "string",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"description": "Optional category filter."
}
}
}🟢route_call(endpoint_id, data_type, q, params, l402_credential, ...)
BitTuitive pays a scoreboard-verified L402 API and returns its data plus routing metadata — use this when the data you need is on another paid API. Price: upstream price + routing fee (max(20%, 3 sats)); the 402 body shows the all-in amount. Sample (illustrative, not live): {"data":{"note":"The upstream API's JSON body is returned here unchanged."},"routing":{"routed_by":"BitTuitive L402 router","upstream":{"endpoint_id":"example-id","name":"Example L402 API","host":"example.com","data_type":"bitcoin","score":92},"paid_sats":15,"upstream_price_sats":10,"fee_sats":5,"fallback_used":false}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay the same all-in price in USDC on Base via x402 (see `price_usd`, `price_breakdown_usd` and `accepts`; routing fee included): sign accepts[0] with an x402 client and call route_call again with the SAME arguments plus the PaymentPayload in params._meta['x402/payment'] (or the base64 x402_payment argument). A routed call pays an upstream API, so your USDC is settled first; if every upstream fails you get a single-use credit token (pass it as `credit`). Give endpoint_id (from route_endpoints) OR data_type and/or q (best pick, with fallback). If status is 'running', repeat the same call with the same l402_credential, credit or x402_payment.
Eingabe-Schema
{
"type": "object",
"properties": {
"endpoint_id": {
"type": "string",
"description": "Scoreboard id from route_endpoints."
},
"data_type": {
"type": "string",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
]
},
"q": {
"type": "string",
"description": "Keywords for best-pick mode, e.g. 'air quality'."
},
"params": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Optional query parameters forwarded to the upstream API."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
},
"credit": {
"type": "string",
"description": "Credit token from a failed routed call (instead of paying)."
}
}
}🟢get_btc_price(l402_credential, x402_payment)
Live BTC price in USD/EUR with 24h change, cached up to 60 seconds — use this when you only need the spot price and a one-minute quote is enough. Price: 10 sats (Lightning) or $0.01 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_price","data":{"price_usd":97500.0,"price_eur":90120.5,"change_24h_percent":1.23,"stale":false,"timestamp":"2026-11-15T20:00:00Z"},"metadata":{"cost_sats":10}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_btc_price_fresh(l402_credential, x402_payment)
Fresh BTC spot in USD/EUR with 24h change, cached at most 10 seconds — use this instead of btc_price when you need a tighter quote (btc_price is 10 sats and cached 60 seconds). Upstream gold-api.com typically prints about every 30 seconds; this tier returns the latest print within 10 seconds of it landing. Price: 30 sats (Lightning) or $0.025 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_price_fresh","data":{"price_usd":97500.0,"price_eur":90120.5,"change_24h_percent":1.23,"source":"gold-api.com","stale":false,"age_seconds":4.2,"timestamp":"2026-11-16T18:00:00Z"},"metadata":{"cost_sats":30}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_btc_oracle(l402_credential, x402_payment)
BTC price plus hash rate, mempool, difficulty, fees and block height — use this for a compact network snapshot. Price: 50 sats (Lightning) or $0.05 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_oracle","data":{"market":{"price_usd":97500.0,"price_eur":90120.5,"change_24h_percent":1.23,"stale":false},"on_chain":{"hash_rate_eh":750.0,"mempool_size_tx":15000,"difficulty":110000000000000.0,"block_height":920000},"fees":{"avg_fee_sat_vbyte":8,"fast_fee_sat_vbyte":14,"slow_fee_sat_vbyte":2}},"metadata":{"cost_sats":50}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_btc_pro(l402_credential, x402_payment)
Oracle data plus Lightning Network capacity/channels and daily mining revenue — use this for ecosystem-level stats. Price: 100 sats (Lightning) or $0.10 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_pro","data":{"market":{"price_usd":97500.0,"change_24h_percent":1.23},"on_chain":{"hash_rate_eh":750.0,"block_height":920000},"lightning":{"capacity_btc":5200.0,"channel_count":12000,"node_count":13000},"mining":{"daily_revenue_btc":450.0,"daily_revenue_usd":43875000.0}},"metadata":{"cost_sats":100}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_btc_signals(l402_credential, x402_payment)
Fear & Greed, BTC/gold, % from ATH, momentum, volatility and 24h transactions (dominance, NVT and active addresses are null without a licensed source) — use this for market-signal context. Price: 200 sats (Lightning) or $0.20 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_signals","data":{"sentiment":{"fear_greed_index":42,"fear_greed_classification":"Fear"},"market":{"btc_price_usd":97500.0,"btc_dominance_percent":null,"gold_ratio":{"gold_price_usd":2650.0,"btc_gold_ratio":36.79}},"network_activity":{"active_addresses_24h":null,"transactions_24h":450000},"valuation":{"ath_usd":126000.0,"percent_from_ath":-22.6,"nvt_ratio":null},"technicals":{"momentum_score":55,"volatility_regime":"normal"}},"metadata":{"cost_sats":200}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_market_insights(l402_credential, x402_payment)
Ranked agent demand, willingness-to-pay, unmet searches, routed-call volume, the payment conversion funnel and supply–demand gaps (aggregates only) — use this to see what agents are paying for. Price: 500 sats (Lightning) or $0.50 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"market_insights","data":{"generated_at":"2026-11-15T20:00:00Z","privacy":"aggregates only (k-anonymized terms)","requested_data_types":[{"rank":1,"data_type":"weather","count_all":42,"count_7d":12,"count_30d":30,"trend_7d":3,"trend_30d":8,"willingness_to_pay":{"n":8,"p25":10,"p50":25,"p75":50,"p90":100}}],"unmet_searches":{"k_anonymity":3,"top":[{"kind":"route_nomatch","term":"air quality","events":6,"clients":4}]},"routed_call_volume":{"routed_calls":17,"by_data_type":{"bitcoin":11,"weather":6}},"conversion_funnel_30d":{"window_days":30,"totals":{"challenges":400,"attempts":12,"successes":7,"failures":5,"conversion_pct":1.8},"by_endpoint":{"btc_price":{"challenges":120,"attempts":6,"successes":4,"failures":2,"attempt_rate_pct":5.0,"conversion_pct":3.3}}},"supply_vs_demand":[{"data_type":"weather","demand_count_30d":30,"supply_registered":1,"supply_scoreboard":2,"supply_total":3,"gap_score":10.0}]},"metadata":{"cost_sats":500}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_weather_current(lat, lon, location, zip, q, ...)
Current conditions for lat/lon or a US city/ZIP (NOAA NWS in the US; MET Norway elsewhere) — use this for a point weather check. Price: 10 sats (Lightning) or $0.01 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"weather_current","data":{"coverage":"us","source":"noaa_nws","place":{"lat":30.27,"lon":-97.74,"city":"Austin","state":"TX","zip":null},"conditions":{"as_of":"2026-11-15T20:00:00Z","text":"Cloudy","temperature_c":12.0,"temperature_f":53.6,"relative_humidity_percent":70,"wind_speed_mph":8.0}},"metadata":{"cost_sats":10}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude (−90 to 90). Use with lon."
},
"lon": {
"type": "number",
"description": "Longitude (−180 to 180). Use with lat."
},
"location": {
"type": "string",
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q."
},
"zip": {
"type": "string",
"description": "5-digit US ZIP code."
},
"q": {
"type": "string",
"description": "Same as location: US city or ZIP."
},
"state": {
"type": "string",
"description": "US state or territory code (alerts only), e.g. TX."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_weather_forecast(lat, lon, location, zip, q, ...)
Hourly plus 7-day forecast for lat/lon or a US city/ZIP — use this to plan the next hours or days. Price: 30 sats (Lightning) or $0.025 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"weather_forecast","data":{"coverage":"us","source":"noaa_nws","place":{"lat":30.27,"lon":-97.74,"city":"Austin","state":"TX"},"forecast":{"updated":"2026-11-15T18:00:00Z","daily":[{"name":"This Afternoon","start":"2026-11-15T13:00:00-06:00","temperature":58,"short_forecast":"Cloudy"}],"hourly":[{"start":"2026-11-15T14:00:00-06:00","temperature":57,"short_forecast":"Cloudy"}]}},"metadata":{"cost_sats":30}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude (−90 to 90). Use with lon."
},
"lon": {
"type": "number",
"description": "Longitude (−180 to 180). Use with lat."
},
"location": {
"type": "string",
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q."
},
"zip": {
"type": "string",
"description": "5-digit US ZIP code."
},
"q": {
"type": "string",
"description": "Same as location: US city or ZIP."
},
"state": {
"type": "string",
"description": "US state or territory code (alerts only), e.g. TX."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_weather_alerts(lat, lon, location, zip, q, ...)
Active NWS alerts for a US point, city, ZIP, or state=XX (US only) — use this to check warnings. Price: 10 sats (Lightning) or $0.01 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"weather_alerts","data":{"coverage":"us","source":"noaa_nws","count":1,"alerts":[{"event":"Wind Advisory","severity":"Moderate","headline":"Wind Advisory in effect until 6 PM CST","onset":"2026-11-15T12:00:00-06:00","expires":"2026-11-15T18:00:00-06:00"}]},"metadata":{"cost_sats":10}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude (−90 to 90). Use with lon."
},
"lon": {
"type": "number",
"description": "Longitude (−180 to 180). Use with lat."
},
"location": {
"type": "string",
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q."
},
"zip": {
"type": "string",
"description": "5-digit US ZIP code."
},
"q": {
"type": "string",
"description": "Same as location: US city or ZIP."
},
"state": {
"type": "string",
"description": "US state or territory code (alerts only), e.g. TX."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_airport_delays(airport, iata, icao, q, l402_credential, ...)
US airport ground stops, delay programs, arrival/departure delays and closures from the FAA NAS Status snapshot (optional airport=SFO). Not for navigation. Not endorsed by the FAA. Price: 10 sats (Lightning) or $0.01 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"airport_delays","data":{"coverage":"us","source":"faa_nas_status","updated":"2026-11-15T20:00:00Z","counts":{"ground_stops":1,"ground_delays":2,"arrival_departure_delays":1,"closures":1,"airports_affected":5,"events":5},"events":[{"airport":"SFO","type":"ground_delay","reason":"wind"}],"airports":["SFO"],"not_for_navigation":true},"metadata":{"cost_sats":10}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"airport": {
"type": "string",
"description": "US airport IATA (SFO) or ICAO (KSFO) code. Required for get_travel_airport; optional filter for get_airport_delays."
},
"iata": {
"type": "string",
"description": "Alias of airport."
},
"icao": {
"type": "string",
"description": "Alias of airport."
},
"q": {
"type": "string",
"description": "Alias of airport."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_travel_airport(airport, iata, icao, q, l402_credential, ...)
One US airport (airport=SFO required): FAA delay/closure events plus current NOAA weather and NWS alerts. Not for navigation. Not endorsed by the FAA or NOAA. Price: 30 sats (Lightning) or $0.025 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"travel_airport","data":{"coverage":"us","source":"faa_nas_status","airport":{"iata":"SFO","icao":"KSFO","name":"San Francisco Intl","state":"CA","lat":37.6188,"lon":-122.375},"delays":{"has_published_event":true,"events":[{"airport":"SFO","type":"ground_delay","reason":"wind"}]},"weather":{"conditions":{"text":"Windy","temperature_f":58.0}},"alerts":{"coverage":"us","source":"noaa_nws","count":0,"alerts":[]},"not_for_navigation":true},"metadata":{"cost_sats":30}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"airport": {
"type": "string",
"description": "US airport IATA (SFO) or ICAO (KSFO) code. Required for get_travel_airport; optional filter for get_airport_delays."
},
"iata": {
"type": "string",
"description": "Alias of airport."
},
"icao": {
"type": "string",
"description": "Alias of airport."
},
"q": {
"type": "string",
"description": "Alias of airport."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_stock_fundamentals(symbol, l402_credential, x402_payment)
SEC EDGAR company facts (revenue, net income, EPS, shares, cash, debt) and ticker-to-CIK mapping for one US ticker. Not endorsed by the SEC. Price: 30 sats (Lightning) or $0.025 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"stock_fundamentals","data":{"company":{"ticker":"NVDA","cik":"0001045810","name":"NVIDIA CORP"},"metrics":{"revenue":{"value":60922000000,"unit":"USD","end":"2025-01-26","form":"10-K"},"net_income":{"value":29760000000,"unit":"USD"},"eps":{"value":1.19,"unit":"USD / shares"}}},"metadata":{"cost_sats":30}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "US ticker. EDGAR accepts any symbol in the SEC company_tickers.json map (featured: SPY, QQQ, NVDA, TSLA, AAPL, MSFT, AMZN, META, GOOGL, AMD, AVGO, MU, PLTR, NBIS, CRWV, RKLB, INTC, ASTS, HIMS, TSM, SOFI, ORCL, HOOD, NFLX, SMCI, COIN, MSTR, IBIT, MARA, GME)."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
},
"required": [
"symbol"
]
}🟢get_stock_filings(symbol, l402_credential, x402_payment)
Latest 10-K, 10-Q and 8-K filings with document links from SEC EDGAR for one US ticker. Not endorsed by the SEC. Price: 10 sats (Lightning) or $0.01 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"stock_filings","data":{"company":{"ticker":"NVDA","cik":"0001045810","name":"NVIDIA CORP"},"count":3,"forms":["8-K","10-Q","10-K"],"filings":[{"form":"8-K","filed":"2026-11-01","accession":"0001045810-26-000001","document_url":"https://www.sec.gov/Archives/edgar/data/1045810/000104581026000001/nvda-8k.htm","index_url":"https://www.sec.gov/Archives/edgar/data/1045810/000104581026000001/0001045810-26-000001-index.html"}]},"metadata":{"cost_sats":10}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "US ticker. EDGAR accepts any symbol in the SEC company_tickers.json map (featured: SPY, QQQ, NVDA, TSLA, AAPL, MSFT, AMZN, META, GOOGL, AMD, AVGO, MU, PLTR, NBIS, CRWV, RKLB, INTC, ASTS, HIMS, TSM, SOFI, ORCL, HOOD, NFLX, SMCI, COIN, MSTR, IBIT, MARA, GME)."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
},
"required": [
"symbol"
]
}🟢get_btc_price_lite(l402_credential, x402_payment)
BTC price in whole US dollars, refreshed at most every 5 minutes (3 sats) — use this when you only need a rough spot price; no EUR or 24h change (btc_price has both). Price: 3 sats (Lightning) or $0.005 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"btc_price_lite","data":{"price_usd":97500,"stale":false,"timestamp":"2026-11-15T20:00:00Z"},"metadata":{"cost_sats":3}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟢get_weather_now(lat, lon, location, zip, q, ...)
Temperature (F), wind and a text summary for a US city/ZIP or lat/lon, about 1 km resolution, cached up to 15 minutes (5 sats) — use this for a rough current check; weather_current adds humidity, Celsius and the station. Price: 5 sats (Lightning) or $0.005 USDC on Base (x402). Sample (illustrative, not live): {"status":"success","endpoint":"weather_now","data":{"coverage":"us","source":"noaa_nws","place":{"city":"Austin","state":"TX","lat":30.27,"lon":-97.74},"conditions":{"as_of":"2026-11-15T20:00:00Z","text":"Cloudy","temperature_f":53.6,"wind_speed_mph":8.0}},"metadata":{"cost_sats":5}} Pay: Call it, get HTTP 402 (or MCP payment_required) with a Lightning invoice and macaroon, pay the invoice, then retry with `Authorization: L402 <macaroon>:<preimage>`. Or pay in USDC on Base via x402: sign the 402's x402 requirement (PAYMENT-REQUIRED header, or `accepts` in the JSON body) and retry with the PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1) header; only a 200 is settled.
Eingabe-Schema
{
"type": "object",
"properties": {
"lat": {
"type": "number",
"description": "Latitude (−90 to 90). Use with lon."
},
"lon": {
"type": "number",
"description": "Longitude (−180 to 180). Use with lat."
},
"location": {
"type": "string",
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q."
},
"zip": {
"type": "string",
"description": "5-digit US ZIP code."
},
"q": {
"type": "string",
"description": "Same as location: US city or ZIP."
},
"state": {
"type": "string",
"description": "US state or territory code (alerts only), e.g. TX."
},
"l402_credential": {
"type": "string",
"description": "Optional L402 credential '<macaroon>:<preimage_hex>' (or 'L402 <macaroon>:<preimage>') from a paid invoice or an active subscription. Omit it to receive the Lightning invoice and macaroon."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
}
}
}🟡create_feed(bitfeed_token, endpoint, mode, interval, interval_seconds, ...)
Create a scheduled or trigger feed. Omit bitfeed_token to open a new prepaid account; the response includes a btf_ token that is not shown again. Delivery is a webhook and/or mailbox. Each delivery costs the same as a normal call to that endpoint. Top up with the topup tool before the feed can deliver. Docs: https://api.bittuitive.ai/data/feed
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"endpoint": {
"type": "string",
"description": "Direct endpoint, e.g. btc_price, btc_price_lite, weather_now, weather_alerts, airport_delays, stock_filings."
},
"mode": {
"type": "string",
"enum": [
"schedule",
"trigger"
]
},
"interval": {
"type": "string",
"description": "hourly, daily, or a number of seconds (schedule mode)."
},
"interval_seconds": {
"type": "integer"
},
"trigger": {
"type": "object",
"description": "Trigger object when mode is trigger. type is one of btc_move (percent, optional window_seconds), btc_threshold (above and/or below in USD), weather_alert (location), airport_delay (airport, optional min_delay_minutes), sec_filing (symbol, optional forms; default 8-K, 10-Q, 10-K; endpoint stock_filings). Optional max_fires, expires_at, cooldown_seconds."
},
"params": {
"type": "object",
"description": "Endpoint params, e.g. {location} or {airport} or {symbol}."
},
"webhook_url": {
"type": "string",
"description": "https webhook URL. A signing secret is returned once."
},
"mailbox": {
"type": "boolean",
"default": true,
"description": "Store deliveries in the mailbox (default true)."
}
},
"required": [
"endpoint",
"mode"
]
}🟢list_feeds(bitfeed_token)
List this account's feeds and the prepaid sat balance.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
}
},
"required": [
"bitfeed_token"
]
}🟢get_feed(bitfeed_token, feed_id)
Return one feed by id.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
]
}🟡update_feed(bitfeed_token, feed_id, interval, interval_seconds, trigger, ...)
Patch interval, trigger, params, webhook_url or mailbox on an existing feed.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"feed_id": {
"type": "string"
},
"interval": {
"type": "string"
},
"interval_seconds": {
"type": "integer"
},
"trigger": {
"type": "object",
"description": "Trigger object when mode is trigger. type is one of btc_move (percent, optional window_seconds), btc_threshold (above and/or below in USD), weather_alert (location), airport_delay (airport, optional min_delay_minutes), sec_filing (symbol, optional forms; default 8-K, 10-Q, 10-K; endpoint stock_filings). Optional max_fires, expires_at, cooldown_seconds."
},
"params": {
"type": "object"
},
"webhook_url": {
"type": "string"
},
"mailbox": {
"type": "boolean"
}
},
"required": [
"bitfeed_token",
"feed_id"
]
}⚪pause_feed(bitfeed_token, feed_id)
Pause a feed so it will not deliver until resumed.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
]
}⚪resume_feed(bitfeed_token, feed_id)
Resume a paused feed. Fails if the prepaid balance is zero or the feed has expired.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
]
}🔴delete_feed(bitfeed_token, feed_id)
Permanently delete a feed.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
]
}🟢get_balance(bitfeed_token)
Return the prepaid sat balance and a low-balance notice when few deliveries remain.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
}
},
"required": [
"bitfeed_token"
]
}🟡topup(bitfeed_token, amount_sats, amount_usd, x402_payment, payment_hash)
Add prepaid balance. Lightning: pass amount_sats (minimum 100) to get an invoice; pay it, then call again with payment_hash (or GET the check_url) to credit the account. USDC on Base (x402): pass amount_usd (minimum 0.10) to get the payment requirements, sign accepts[0], then call again with the same amount_usd plus x402_payment (or params._meta['x402/payment']); your USDC is settled first and the receipt is in _meta['x402/payment-response']. USDC funds pay deliveries at USDC list prices, sats funds at sats prices. Feeds paused for zero balance resume automatically after credit.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"amount_sats": {
"type": "integer",
"minimum": 100,
"description": "Sats to add (100 to 1,000,000)."
},
"amount_usd": {
"type": "string",
"description": "USDC to add over x402 (0.10 to 50), e.g. \"1.00\"."
},
"x402_payment": {
"type": "string",
"description": "Optional x402 payment (USDC on Base): base64 PaymentPayload (v2, or v1 X-PAYMENT format) signed for accepts[0] of this tool's payment_required result. Alternative to params._meta['x402/payment']. Omit both to receive the payment requirements."
},
"payment_hash": {
"type": "string",
"description": "Optional. If set, check this invoice instead of creating one."
}
},
"required": [
"bitfeed_token"
]
}🟢get_mailbox(bitfeed_token, item_id, feed_id, include_acked)
List or fetch mailbox items (payloads stored when a webhook is not used or has failed). Items are kept for 72 hours.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"item_id": {
"type": "string",
"description": "Optional. Fetch one mailbox item."
},
"feed_id": {
"type": "string"
},
"include_acked": {
"type": "boolean",
"default": false
}
},
"required": [
"bitfeed_token"
]
}⚪ack_mailbox(bitfeed_token, item_id)
Mark a mailbox item as acked so it is hidden from the default list.
Eingabe-Schema
{
"type": "object",
"properties": {
"bitfeed_token": {
"type": "string",
"description": "Feed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once."
},
"item_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"item_id"
]
}Community
Nachweis