swarmio

endpoint

https://ioswarm.io/mcp

door code

8339036ddabe6b85

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

10 · newcomer

Is swarmio live?

Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.

Is swarmio free to use?

Partly — some of its tools are open, others need a key or payment.

What tools does swarmio have?

14 tools: search, news.brief, route.classify, runs.launch, runs.cancel, runs.wait, runs.get, runs.report, ….

Is swarmio safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• fetch reads 0.02 USDC paid never probed

  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.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "id"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "A result id from search (a run id)."
      }
    }
  }

  arguments 12 lines copy
• market.pulse reads open 41d ago

  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.

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• billing.topup_terms reads open 42d ago

  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.

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• modes.list reads open 42d ago

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

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• billing.balance reads auth-required 42d ago

  The caller's credit balance and plan state.

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• search reads unknown never probed

  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.)

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "query"
    ],
    "properties": {
      "query": {
        "type": "string",
        "description": "Words to match against report titles and text."
      }
    }
  }

  arguments 12 lines copy
• news.brief reads unknown never probed

  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).

  mcp-tool

  1234

  {
    "type": "object",
    "properties": {}
  }

  arguments 4 lines copy
• route.classify reads unknown never probed

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

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "prompt": {
        "type": "string",
        "description": "The freeform request to classify, e.g. 'compare the best espresso grinders under $300'."
      }
    }
  }

  arguments 12 lines copy
• runs.launch changes data unknown never probed

  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).

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "required": [
      "mode",
      "input"
    ],
    "properties": {
      "mode": {
        "type": "string",
        "description": "A mode id from modes.list, e.g. 'research'."
      },
      "input": {
        "type": "string",
        "description": "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": {
        "type": "integer",
        "description": "Optional parallelism override (worker count). Omit for the mode default."
      }
    }
  }

  arguments 21 lines copy
• runs.cancel changes data unknown never probed

  Stop a running job.

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "run_id"
    ],
    "properties": {
      "run_id": {
        "type": "string",
        "description": "The run_id returned by runs.launch."
      }
    }
  }

  arguments 12 lines copy
• runs.wait reads unknown never probed

  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.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "run_id"
    ],
    "properties": {
      "run_id": {
        "type": "string",
        "description": "The run_id returned by runs.launch."
      },
      "timeout_secs": {
        "type": "integer",
        "description": "How long this call may wait before returning the current status. Default 90, max 240."
      }
    }
  }

  arguments 16 lines copy
• runs.get reads unknown never probed

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

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "run_id"
    ],
    "properties": {
      "run_id": {
        "type": "string",
        "description": "The run_id returned by runs.launch."
      }
    }
  }

  arguments 12 lines copy
• runs.report reads unknown never probed

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

  mcp-tool

  123456789101112

  {
    "type": "object",
    "required": [
      "run_id"
    ],
    "properties": {
      "run_id": {
        "type": "string",
        "description": "The run_id returned by runs.launch."
      }
    }
  }

  arguments 12 lines copy
• web.search reads unknown never probed

  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.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "query"
    ],
    "properties": {
      "k": {
        "type": "integer",
        "description": "Results wanted, 1-5 (free-leg cap)."
      },
      "query": {
        "type": "string",
        "description": "The live-web query, up to 500 characters."
      }
    }
  }

  arguments 16 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.