SwarmIO

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

AI that does real work for you: cited web research, plans, finance, horoscopes. Self-serve.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "SwarmIO": {
      "url": "https://ioswarm.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (14)

• market.pulse read-only

  FREE, no key, no account: live prices for BTC, ETH, SOL, AMZN and NVDA with the session's change, plus today's news — the platform's newest published news digest parsed into stories with source links, and the market wire's latest headlines. Refreshed every minute (prices) and every ten minutes (news). Call this first to see what the swarm's data looks like before spending anything.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search read-only

  Search the swarm's published research: the featured shelf, the operator's daily news / markets / AI digests, and — when a key is presented — the caller's own reports. Every hit is a finished, cited, evidence-graded report. Returns {results:[{id,title,url}]}; pass an id to fetch. No key needed for the public corpus. (The research-connector contract: this is what a ChatGPT or Claude connector calls.)

  Parameters:

  • query (required) — string — Words to match against report titles and text.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• fetch read-only

  Read one report by the id search returned: the full markdown text with its citations and evidence header, plus title, url and metadata. Public reports need no key; a caller's own reports need theirs.

  Parameters:

  • id (required) — string — A result id from search (a run id).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• web.search read-only

  FREE, no key, no account: LIVE web search, 25 queries a day per caller, up to 5 results each ({results:[{url,title,snippet,published}], quota, report}). This is the open web, not the published corpus — for the platform's finished reports use `search`. Over the daily quota the paid leg is $0.02 per call over x402 (USDC on Base): POST https://ioswarm.io/api/v1/search with the same JSON body and no payment header, read the 402, sign the EIP-3009 authorization, re-send with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) — no account is created. The response's `report` field shows the one-call cited research brief (5¢, pay-only) for when raw results are not enough.

  Parameters:

  • query (required) — string — The live-web query, up to 500 characters.
  • k — integer — Results wanted, 1-5 (free-leg cap).

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• news.brief read-only

  PAID, 5¢ per call over x402 (USDC on Base, no account): today's market-news brief — this platform's newest published news digest synthesized with the live market wire into a cited bullet list, every finding ending with its source URL. No input required; the settle happens over HTTP, where the payment headers live: this tool returns the exact steps. The FREE raw material it is written from is market.pulse on this same server (the digest stories and wire headlines, un-synthesized).

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• route.classify read-only

  Classify a freeform request into the right mode (research, news, finance, astrology, …) before spending a run. Never charged.

  Parameters:

  • prompt (required) — string — The freeform request to classify, e.g. 'compare the best espresso grinders under $300'.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• runs.launch

  Launch a run: agents search the web, read sources, and write a cited report — real work, done for the caller. BILLED from the caller's credits. Returns the run record; poll runs.get until completed, then runs.report. Modes: research, news, product, trips, trainer, finance, astrology, horoscope (astrology/horoscope take Birth date constraint lines — see https://ioswarm.io/llms.txt).

  Parameters:

  • mode (required) — string — A mode id from modes.list, e.g. 'research'.
  • input (required) — string — The question or brief. astrology/horoscope take constraint lines ('- Birth date: YYYY-MM-DD', optional Birth time + Timezone, Latitude/Longitude) — contract at https://ioswarm.io/llms.txt.
  • max_workers — integer — Optional parallelism override (worker count). Omit for the mode default.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• runs.get read-only

  A run's status and metadata. Poll until status is completed/failed/cancelled.

  Parameters:

  • run_id (required) — string — The run_id returned by runs.launch.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• runs.wait read-only

  Block until a run finishes, then return its record — and its report when it completed. Runs take 3–10 minutes; call this instead of polling runs.get in a loop. Returns early with timed_out=true after timeout_secs (default 90, max 240): call it again with the same run_id to keep waiting. Never charged.

  Parameters:

  • run_id (required) — string — The run_id returned by runs.launch.
  • timeout_secs — integer — How long this call may wait before returning the current status. Default 90, max 240.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• runs.report read-only

  The finished, cited report for a completed run (report_text is markdown).

  Parameters:

  • run_id (required) — string — The run_id returned by runs.launch.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• runs.cancel destructive

  Stop a running job.

  Parameters:

  • run_id (required) — string — The run_id returned by runs.launch.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• billing.balance read-only

  The caller's credit balance and plan state.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• billing.topup_terms read-only

  How to refill credits machine-to-machine: USDC on Base to a published address, verified on-chain. Returns the pay_to address, minimum, and rate. Public — no credentials needed.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• modes.list read-only

  The launchable modes with a one-line contract for each. Static; never charged, no credentials needed.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.