SwarmIO

{
  "protocolVersion": "1.0.0",
  "name": "SwarmIO",
  "description": "A hosted agent harness: deep research as an API. One call kicks off a swarm that plans the work, browses, reads the sources, and cross-checks what it finds, then returns a cited report \u2014 you poll or stream for the result. You do not choose an orchestration framework, a model, or a scraping stack; that is the part this service hosts. Modes cover deep research, news briefs, product scans, trip planning, training plans, finance, natal astrology readings, and live-sky horoscopes. Agents need no account: POST /api/v1/x402/run/<mode> with a brief, pay the 402 in USDC on Base (x402, both wire versions), and the run starts \u2014 the paying wallet becomes the account and an API key comes back once (GET /api/v1/x402/run lists modes and prices). Or self-onboard with no human: sign up, register, mint an sk_swarm_ key, spend the starter credits, top up over x402 \u2014 the full path is https://ioswarm.io/llms.txt. Free with no credentials: GET /api/v1/pulse (live prices and today's news). Also speaks MCP at https://ioswarm.io/mcp and publishes an OpenAPI spec at https://ioswarm.io/api/v1/openapi.json.",
  "url": "https://ioswarm.io",
  "version": "1.0.0",
  "provider": {
    "organization": "SwarmIO",
    "url": "https://ioswarm.io"
  },
  "documentationUrl": "https://ioswarm.io/llms.txt",
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "securitySchemes": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "sk_swarm_ API key, self-minted with no human per https://ioswarm.io/llms.txt (a Supabase access_token from the signup call also works)"
    },
    "x402": {
      "type": "http",
      "scheme": "x402",
      "description": "Pay per run with USDC on Base: POST a run resource, answer the 402 with a signed EIP-3009 authorization in X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2). No prior account \u2014 the wallet becomes one."
    }
  },
  "security": [
    {
      "bearer": []
    },
    {
      "x402": []
    }
  ],
  "skills": [
    {
      "id": "pulse",
      "name": "Live market pulse (free)",
      "description": "FREE, no key and no account: live prices for BTC, ETH, SOL, AMZN and NVDA with the session's change, today's stories from the platform's newest published news digest (with a link to the full cited report), and the market wire's latest headlines. GET https://ioswarm.io/api/v1/pulse, or the MCP tool market.pulse.",
      "tags": [
        "free",
        "prices",
        "crypto",
        "stocks",
        "news",
        "no-auth"
      ],
      "examples": [
        "What are BTC and NVDA doing right now, and what's in the news today?"
      ]
    },
    {
      "id": "search",
      "name": "Live web search (free leg, then 2\u00a2)",
      "description": "POST /api/v1/search {query}: 25 free searches a day per caller (up to 5 results each, no key, no account); past the daily quota the same URL answers 402 \u2014 sign the requirements and re-POST with the payment header for $0.02 and up to 20 results. Also the open MCP tool web.search (free leg; the spent-day reply names the x402 path).",
      "tags": [
        "search",
        "web",
        "free-leg",
        "x402",
        "no-auth"
      ],
      "examples": [
        "Search the live web for 'perovskite solar degradation 2026'."
      ]
    },
    {
      "id": "search-report",
      "name": "Cited research brief (5\u00a2)",
      "description": "POST /api/v1/search/report {query}: one call \u2014 live search (up to 10 results) synthesized into a cited bullet brief, every finding ending with its source URL. $0.05 over x402 (USDC on Base, v1+v2), pay-only. The report on top of the search rail.",
      "tags": [
        "search",
        "report",
        "citations",
        "x402",
        "no-auth"
      ],
      "examples": [
        "Turn 'best evidence on magnesium and sleep' into a cited brief."
      ]
    },
    {
      "id": "news-brief",
      "name": "Cited market-news brief (5\u00a2)",
      "description": "POST /api/v1/news/brief: today's market-news brief in one call \u2014 the platform's newest published news digest synthesized with the live market wire into a cited bullet brief. $0.05 over x402, pay-only; the free raw data behind it is the pulse skill.",
      "tags": [
        "news",
        "markets",
        "brief",
        "x402",
        "no-auth"
      ],
      "examples": [
        "What happened in the markets today, with sources?"
      ]
    },
    {
      "id": "quote",
      "name": "Market quotes (1\u00a2)",
      "description": "POST /api/v1/x402/quote {symbols: [\"NVDA\", \"BTC-USD\", \"EURUSD=X\"]}: live price, session change, currency and source per symbol, missing symbols listed. $0.01 over x402 \u2014 the cheapest paid leg on the platform.",
      "tags": [
        "quotes",
        "prices",
        "stocks",
        "crypto",
        "fx",
        "x402",
        "no-auth"
      ],
      "examples": [
        "Quote BTC-USD, ETH-USD and NVDA right now."
      ]
    },
    {
      "id": "fetch",
      "name": "Page fetch (2\u00a2)",
      "description": "POST /api/v1/x402/fetch {url, extract}: plain HTTP with a browser-grade fingerprint and readable-text extraction (text | links | metadata); JS-only or bot-walled pages come back flagged. Public hosts only. $0.02 over x402.",
      "tags": [
        "fetch",
        "scrape",
        "extraction",
        "x402",
        "no-auth"
      ],
      "examples": [
        "Fetch https://example.com/whitepaper and extract the readable text."
      ]
    },
    {
      "id": "chat",
      "name": "Chat completion (2\u00a2)",
      "description": "POST /api/v1/x402/chat {messages}: one completion on the engine the swarm itself runs (OpenAI message shape, bounded: 24 messages in, 24K characters, 1,024 tokens out). $0.02 over x402 \u2014 no key, no account, no rate-limit dance.",
      "tags": [
        "chat",
        "completion",
        "llm",
        "x402",
        "no-auth"
      ],
      "examples": [
        "One-shot: summarize this error log in three bullets."
      ]
    },
    {
      "id": "research",
      "name": "Deep research",
      "description": "Multi-round web research on any question, ending in a cited report. POST /api/v1/runs with mode=research.",
      "tags": [
        "research",
        "web-search",
        "cited-report"
      ],
      "examples": [
        "Research the current state of solid-state battery commercialization"
      ]
    },
    {
      "id": "news",
      "name": "News brief",
      "description": "A current news brief on a topic, compiled from fresh sources. Mode=news.",
      "tags": [
        "news",
        "briefing"
      ],
      "examples": [
        "What's happening in EU AI regulation this week?"
      ]
    },
    {
      "id": "product",
      "name": "Product scan",
      "description": "Product and market scan: options, prices, trade-offs. Mode=product.",
      "tags": [
        "products",
        "comparison",
        "shopping"
      ],
      "examples": [
        "Compare mechanical keyboards under $150 for office use"
      ]
    },
    {
      "id": "trips",
      "name": "Trip planning",
      "description": "Itineraries and travel research. Mode=trips.",
      "tags": [
        "travel",
        "itinerary"
      ],
      "examples": [
        "Plan 5 days in Lisbon in October, mid-range budget"
      ]
    },
    {
      "id": "trainer",
      "name": "Training plans",
      "description": "Personal training/coaching plans. Mode=trainer.",
      "tags": [
        "fitness",
        "coaching"
      ],
      "examples": [
        "Build a 8-week couch-to-10k running plan"
      ]
    },
    {
      "id": "finance",
      "name": "Finance analysis",
      "description": "Market and finance research briefs. Mode=finance.",
      "tags": [
        "finance",
        "markets"
      ],
      "examples": [
        "Brief me on NVIDIA's quarter and the AI capex cycle"
      ]
    },
    {
      "id": "astrology",
      "name": "Natal astrology reading",
      "description": "A full natal reading for any person from server-computed chart positions (never model-invented). Birth date required; time/timezone/coordinates optional. Mode=astrology \u2014 input contract in llms.txt.",
      "tags": [
        "astrology",
        "natal-chart"
      ],
      "examples": [
        "A natal reading for someone born 1990-06-15, 14:30, Leeds"
      ]
    },
    {
      "id": "horoscope",
      "name": "Live-sky horoscope",
      "description": "The sky right now: every planet's live position, aspects, retrogrades, and the Moon's phase, computed server-side. No birth data needed; folds in the caller's saved chart when present. Mode=horoscope.",
      "tags": [
        "horoscope",
        "astrology",
        "transits"
      ],
      "examples": [
        "What is the sky doing today?"
      ]
    },
    {
      "id": "route",
      "name": "Mode routing",
      "description": "Classify a freeform request into the right mode before spending a run. POST /api/v1/route \u2014 never charged.",
      "tags": [
        "routing",
        "classification"
      ],
      "examples": [
        "Where should 'what should I read about the lithium market' go?"
      ]
    }
  ],
  "additionalInterfaces": [
    {
      "url": "https://ioswarm.io/.well-known/x402.json",
      "transport": "x402 discovery"
    },
    {
      "url": "https://ioswarm.io/mcp",
      "transport": "MCP"
    },
    {
      "url": "https://ioswarm.io/api/v1/openapi.json",
      "transport": "OpenAPI"
    },
    {
      "url": "https://ioswarm.io/llms.txt",
      "transport": "llms.txt"
    }
  ]
}