Server definition
- Hash
- sha256:8709d70b4953f215ff05bc0853200ad4c778813abdc7aaa7c14890089d0a659d
- What it is
- What a remote MCP server returned when asked what it offers: 32 tools
The blob, as servednamed by its sha256
{
"instructions": "BitTuitive: One Payment, BTC or USDC, Any Verified Data Point, routed to the highest-rated source with automatic fallback. Reliable data for AI agents, paid per call over Lightning (L402); see the ROUTER section below. FREE: an independent scoreboard of paid agent APIs (L402 and x402) grouped by data type (bitcoin, crypto, stocks, weather, traffic, other) with 0-100 quality scores from unpaid probes: use best_endpoint to pick a reliable API for a need, scoreboard_search to browse, scoreboard_categories for the top of each type. Each paid tool description lists the price in sats, an illustrative sample result (not live data), and how to pay. Call a paid tool without l402_credential to get a payment_required error (isError=true) with a Lightning invoice and macaroon. Pay that invoice yourself (lnget, a Lightning wallet, or NWC / the Alby SDK), then retry with l402_credential='<macaroon>:<preimage_hex>' or Authorization: L402 <macaroon>:<preimage>. One payment = one response (use within 10 minutes). Subscriptions (30 days, daily quota) also work as l402_credential. This server never spends from your wallet. Paid data tools also accept USDC on Base via x402: the payment_required result carries x402Version, resource and accepts (scheme exact, eip155:8453, USDC amount in atomic units, payTo); sign accepts[0] and call the tool again with the PaymentPayload in params._meta['x402/payment'] (or a base64 x402_payment argument); the receipt comes back in _meta['x402/payment-response']. Only successful calls are settled. If nothing matches what you need, use the free request_data tool (or POST /api/v1/request-data) to record a demand signal; BitTuitive does not auto-add sources. Ranked counts and trends are the paid get_market_insights tool (also in the pro subscription); public /api/v1/insights/* pages are teasers only. BITFEED: prepaid Lightning feeds that push data on a schedule or when a trigger hits (BTC percent move, BTC threshold, NOAA weather alert, airport delay). Each delivery costs the same as a normal call to that endpoint. Tools: create_feed (omit bitfeed_token to open an account; store the btf_ token), list_feeds, get_feed, update_feed, pause_feed, resume_feed, delete_feed, get_balance, topup, get_mailbox, ack_mailbox. Page: https://api.bittuitive.ai/data/feed STOCKS (L402): get_stock_fundamentals 30 sats and get_stock_filings 10 sats take symbol, any US ticker that maps to an SEC CIK (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). First-party FMP quotes stay off; the router only fetches stock prices from vetted sources. ROUTER (one payment, sats or USDC, any verified data API): route_endpoints lists every scoreboard-verified L402 data API BitTuitive can call for you, ranked by quality score and latency; route_call buys one call: you pay ONE BitTuitive invoice, or the same all-in price in USDC on Base via x402 (upstream price + routing fee: max(20%, 3 sats)), BitTuitive pays the upstream API, calls it and returns its data with routing metadata (upstream, score, fee). Pick by endpoint_id or by data_type/q (highest-rated endpoint, automatic fallback to the next-best). Call route_call again with the SAME arguments plus l402_credential after paying. If it reports status 'running', call again the same way to collect the result. If every upstream fails you get a credit token (24 h) to pass as `credit`. USDC: the route_call payment_required result also carries x402Version, resource, accepts, price_usd and price_breakdown_usd; sign accepts[0] and call route_call again with the SAME arguments plus params._meta['x402/payment'] (or a base64 x402_payment argument). Your USDC is settled before BitTuitive pays any upstream; the receipt is in _meta['x402/payment-response'] and paid_with. Plain HTTP GET /api/v1/route/... accepts the same payment. Vetted sources only: BitTuitive routes just to upstreams that pass its own recent probes (quality score >= 80) and policy checks (no scrapers, URL fetchers or LLM endpoints); stock prices route only to sources with a disclosed redistribution license, and registered providers must disclose their data source and license and pass review before they are routed. BitTuitive's own data comes from public-domain or openly licensed sources (NOAA, FAA, SEC EDGAR, MET Norway). Upstreams are picked by reliability score and latency, with automatic fallback. WEATHER (L402): get_weather_current 10 sats, get_weather_forecast 30 sats, get_weather_alerts 10 sats. Pass lat and lon, or location='Austin, TX' / zip=10001 (US Census Gazetteer). Alerts also accept state=TX. US data is from NOAA NWS (public domain, not endorsed by NOAA). Current/forecast outside the US use MET Norway (CC BY 4.0). Alerts are US-only. A missing location returns an error before any invoice. TRAVEL (L402): get_airport_delays 10 sats (optional airport=SFO for one airport, or omit for the full FAA snapshot) and get_travel_airport 30 sats (airport required: delays plus current weather and NWS alerts). Source: Federal Aviation Administration NAS Status (public domain, not for navigation, not endorsed by the FAA). A missing or invalid airport on get_travel_airport returns an error before any invoice.",
"tools": [
{
"description": "Mark a mailbox item as acked so it is hidden from the default list.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"item_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"item_id"
],
"type": "object"
},
"name": "ack_mailbox",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"data_type": {
"description": "Optional category filter.",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"type": "string"
},
"limit": {
"default": 3,
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"need": {
"description": "What the API should provide (keywords).",
"type": "string"
},
"protocol": {
"description": "Optional payment protocol filter.",
"enum": [
"L402",
"x402"
],
"type": "string"
}
},
"required": [
"need"
],
"type": "object"
},
"name": "best_endpoint",
"outputSchema": null
},
{
"description": "Free. BitTuitive's paid endpoints, per-call prices in sats, subscription plans, and live status.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "bittuitive_pricing",
"outputSchema": null
},
{
"description": "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",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"endpoint": {
"description": "Direct endpoint, e.g. btc_price, weather_alerts, airport_delays.",
"type": "string"
},
"interval": {
"description": "hourly, daily, or a number of seconds (schedule mode).",
"type": "string"
},
"interval_seconds": {
"type": "integer"
},
"mailbox": {
"default": true,
"description": "Store deliveries in the mailbox (default true).",
"type": "boolean"
},
"mode": {
"enum": [
"schedule",
"trigger"
],
"type": "string"
},
"params": {
"description": "Endpoint params, e.g. {location} or {airport} or {symbol}.",
"type": "object"
},
"trigger": {
"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). Optional max_fires, expires_at, cooldown_seconds.",
"type": "object"
},
"webhook_url": {
"description": "https webhook URL. A signing secret is returned once.",
"type": "string"
}
},
"required": [
"endpoint",
"mode"
],
"type": "object"
},
"name": "create_feed",
"outputSchema": null
},
{
"description": "Permanently delete a feed.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
],
"type": "object"
},
"name": "delete_feed",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"airport": {
"description": "US airport IATA (SFO) or ICAO (KSFO) code. Required for get_travel_airport; optional filter for get_airport_delays.",
"type": "string"
},
"iata": {
"description": "Alias of airport.",
"type": "string"
},
"icao": {
"description": "Alias of airport.",
"type": "string"
},
"l402_credential": {
"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.",
"type": "string"
},
"q": {
"description": "Alias of airport.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_airport_delays",
"outputSchema": null
},
{
"description": "Return the prepaid sat balance and a low-balance notice when few deliveries remain.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
}
},
"required": [
"bitfeed_token"
],
"type": "object"
},
"name": "get_balance",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_btc_oracle",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_btc_price",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_btc_price_fresh",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_btc_pro",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_btc_signals",
"outputSchema": null
},
{
"description": "Return one feed by id.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
],
"type": "object"
},
"name": "get_feed",
"outputSchema": null
},
{
"description": "List or fetch mailbox items (payloads stored when a webhook is not used or has failed). Items are kept for 72 hours.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
},
"include_acked": {
"default": false,
"type": "boolean"
},
"item_id": {
"description": "Optional. Fetch one mailbox item.",
"type": "string"
}
},
"required": [
"bitfeed_token"
],
"type": "object"
},
"name": "get_mailbox",
"outputSchema": null
},
{
"description": "Ranked agent demand, willingness-to-pay, unmet searches, routed-call volume 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}},\"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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_market_insights",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"symbol": {
"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).",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_stock_filings",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"symbol": {
"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).",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "get_stock_fundamentals",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"airport": {
"description": "US airport IATA (SFO) or ICAO (KSFO) code. Required for get_travel_airport; optional filter for get_airport_delays.",
"type": "string"
},
"iata": {
"description": "Alias of airport.",
"type": "string"
},
"icao": {
"description": "Alias of airport.",
"type": "string"
},
"l402_credential": {
"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.",
"type": "string"
},
"q": {
"description": "Alias of airport.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "get_travel_airport",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"lat": {
"description": "Latitude (−90 to 90). Use with lon.",
"type": "number"
},
"location": {
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q.",
"type": "string"
},
"lon": {
"description": "Longitude (−180 to 180). Use with lat.",
"type": "number"
},
"q": {
"description": "Same as location: US city or ZIP.",
"type": "string"
},
"state": {
"description": "US state or territory code (alerts only), e.g. TX.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
},
"zip": {
"description": "5-digit US ZIP code.",
"type": "string"
}
},
"type": "object"
},
"name": "get_weather_alerts",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"lat": {
"description": "Latitude (−90 to 90). Use with lon.",
"type": "number"
},
"location": {
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q.",
"type": "string"
},
"lon": {
"description": "Longitude (−180 to 180). Use with lat.",
"type": "number"
},
"q": {
"description": "Same as location: US city or ZIP.",
"type": "string"
},
"state": {
"description": "US state or territory code (alerts only), e.g. TX.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
},
"zip": {
"description": "5-digit US ZIP code.",
"type": "string"
}
},
"type": "object"
},
"name": "get_weather_current",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"l402_credential": {
"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.",
"type": "string"
},
"lat": {
"description": "Latitude (−90 to 90). Use with lon.",
"type": "number"
},
"location": {
"description": "US city ('Austin, TX') or 5-digit ZIP. Alias: q.",
"type": "string"
},
"lon": {
"description": "Longitude (−180 to 180). Use with lat.",
"type": "number"
},
"q": {
"description": "Same as location: US city or ZIP.",
"type": "string"
},
"state": {
"description": "US state or territory code (alerts only), e.g. TX.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
},
"zip": {
"description": "5-digit US ZIP code.",
"type": "string"
}
},
"type": "object"
},
"name": "get_weather_forecast",
"outputSchema": null
},
{
"description": "List this account's feeds and the prepaid sat balance.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
}
},
"required": [
"bitfeed_token"
],
"type": "object"
},
"name": "list_feeds",
"outputSchema": null
},
{
"description": "Pause a feed so it will not deliver until resumed.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
],
"type": "object"
},
"name": "pause_feed",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"contact": {
"description": "Optional email so an operator can follow up. Never published.",
"type": "string"
},
"data_type": {
"description": "Category, e.g. weather, stocks, traffic, other.",
"type": "string"
},
"description": {
"description": "What you need and why it would help.",
"type": "string"
},
"example_query": {
"description": "An example query or URL shape you would send.",
"type": "string"
},
"max_price_sats": {
"description": "Max sats you would pay per call.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"data_type",
"description"
],
"type": "object"
},
"name": "request_data",
"outputSchema": null
},
{
"description": "Resume a paused feed. Fails if the prepaid balance is zero or the feed has expired.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
],
"type": "object"
},
"name": "resume_feed",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"credit": {
"description": "Credit token from a failed routed call (instead of paying).",
"type": "string"
},
"data_type": {
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"type": "string"
},
"endpoint_id": {
"description": "Scoreboard id from route_endpoints.",
"type": "string"
},
"l402_credential": {
"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.",
"type": "string"
},
"params": {
"additionalProperties": {
"type": "string"
},
"description": "Optional query parameters forwarded to the upstream API.",
"type": "object"
},
"q": {
"description": "Keywords for best-pick mode, e.g. 'air quality'.",
"type": "string"
},
"x402_payment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"name": "route_call",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"properties": {
"data_type": {
"description": "Optional category filter.",
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"type": "string"
}
},
"type": "object"
},
"name": "route_endpoints",
"outputSchema": null
},
{
"description": "Free. Per data type (bitcoin, crypto, stocks, weather, traffic, other): counts, average score and the top endpoints.",
"inputSchema": {
"properties": {
"top": {
"default": 3,
"maximum": 10,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"name": "scoreboard_categories",
"outputSchema": null
},
{
"description": "Free. Score components, probe stats and recent probe history for one scoreboard entry (id from best_endpoint/scoreboard_search).",
"inputSchema": {
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "scoreboard_endpoint",
"outputSchema": null
},
{
"description": "Free. Search/browse the scoreboard of paid agent APIs with filters; sorted by score.",
"inputSchema": {
"properties": {
"data_type": {
"enum": [
"bitcoin",
"crypto",
"stocks",
"weather",
"traffic",
"other"
],
"type": "string"
},
"limit": {
"default": 10,
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"min_score": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"offset": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"protocol": {
"enum": [
"L402",
"x402"
],
"type": "string"
},
"q": {
"description": "Text search in name, description and URL.",
"type": "string"
}
},
"type": "object"
},
"name": "scoreboard_search",
"outputSchema": null
},
{
"description": "Issue a Lightning invoice to add sats to the prepaid BitFeed balance (minimum 100). Pay the invoice, then call again or GET the check_url to credit the account. Feeds paused for zero balance resume automatically after credit.",
"inputSchema": {
"properties": {
"amount_sats": {
"description": "Sats to add (100 to 1,000,000).",
"minimum": 100,
"type": "integer"
},
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"payment_hash": {
"description": "Optional. If set, check this invoice instead of creating one.",
"type": "string"
}
},
"required": [
"bitfeed_token"
],
"type": "object"
},
"name": "topup",
"outputSchema": null
},
{
"description": "Patch interval, trigger, params, webhook_url or mailbox on an existing feed.",
"inputSchema": {
"properties": {
"bitfeed_token": {
"description": "BitFeed account token (btf_…). Also accepted as Authorization: Bearer. Omit on the first create_feed to open an account; the token is returned once.",
"type": "string"
},
"feed_id": {
"type": "string"
},
"interval": {
"type": "string"
},
"interval_seconds": {
"type": "integer"
},
"mailbox": {
"type": "boolean"
},
"params": {
"type": "object"
},
"trigger": {
"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). Optional max_fires, expires_at, cooldown_seconds.",
"type": "object"
},
"webhook_url": {
"type": "string"
}
},
"required": [
"bitfeed_token",
"feed_id"
],
"type": "object"
},
"name": "update_feed",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:8709d70b4953f215ff05bc0853200ad4c778813abdc7aaa7c14890089d0a659d | sha256sum