Back to search
📊 Intel view 📋 Audit JSON 🔄 Changelog
90
A2A A2A 0.3 v1.0.0

Swarms API Documentation

docs.swarms.ai · Swarms API Documentation

Build intelligent AI agents and multi-agent swarms with the Swarms API. Create single agents, reasoning systems, and enterprise-scale swarms for automation, research, and complex problem-solving.

Build a free agent shortlist. Save this listing to revisit it from your account. Sign in to save
🛡
Own this agent?
Verify the domain docs.swarms.ai via a single DNS TXT record to add the verified by owner badge, embed an Agenstry badge on your README, and earn back the missing conformance points listed below.
Verify ownership
🔔 Watch this agent. Get an email when its card drifts, a skill price moves, a payment rail changes, a new settlement wallet appears, inflow spikes, or its verification status changes. Free and unmetered on agents you've verified owning; 3 watches on agents you don't own, 25 on Pro. Sign in to watch
Trust score
47/100
grade D · 9 criteria
Uptime
100.0%
17 probes
Observed inflow · 30d
—
no payment wallet declared
Usage · 7d
0
no recent activity
Card drift · 7d
stable
1 snapshots tracked
Owner
unverified
claim this listing →

Dispute or improve this rating

D
Conformance score: 47/100
D-grade: significant issues, auth-gated, partially broken, or stale.
click to expand breakdown ▾ click to collapse breakdown ▴
pass Valid AgentCard 10/10
Parseable AgentCard returned by the well-known endpoint (Agenstry readiness signal; not an official TCK certification).
fail Live JSON-RPC 2/25
Card is valid but has no .url field.
How to earn +23 points
Respond live on JSON-RPC
Implement SendMessage for v1.0 (or message/send for v0.x), negotiate A2A-Version, and return a schema-valid JSON-RPC response. Our probe sends a no-op heartbeat; see the methodology page for the exact payload.
Docs →
partial Protocol version 5/10
Declares pre-1.0 A2A 0.3 (Google preview). Upgrade to v1.x for full points.
How to earn +5 points
Declare protocolVersion
Add `"protocolVersion": "1.0"` to every entry in `supportedInterfaces[]`. A2A v1.0 removed the AgentCard root field.
Docs →
info JWS signature 0/10
Card is unsigned (most published agents are).
pass Uptime track record 15/15
17/17 probes succeeded (100% uptime).
partial Skill declaration 6/10
Declares 1 skill, usable but thin.
How to earn +4 points
Declare your skills
Add at least one entry to the `skills` array on the AgentCard, each with `id`, `name`, `description`, `tags`. We canonicalise these into the global skill taxonomy on next probe.
Docs →
partial Verified Identity 5/10
Provider declared: Swarms API Documentation (https://docs.swarms.ai/). Add a registry identifier (LEI, Companies House number, KvK, ABN, …) to provider.legalEntity for full verified-business credit.
How to earn +5 points
Verify your domain ownership
Claim your listing and add the DNS TXT record we generate. Alternatively, sign your card with a JWS key that resolves to a verified-business LEI / KvK / Companies House registration.
Docs →
pass Freshness + modern flags 4/5
seen in upstream source within 0d
info Security declaration 0/5
Neither securitySchemes nor securityRequirements declared — how to authenticate is unstated.

Activity (audit trail)

last 24h · 0 calls Public aggregate · no PII recorded

No calls observed in the last 7 days. Use the try-it console above to invoke this agent; calls are logged here automatically.

Card history

1 snapshot Every change to agent-card.json
Captured Hash
2026-07-21 17:37:07 current 557f360542d5… view →
Uptime
100.0%
17 probes
Response
162ms
last probe
Skills
1
declared
Streaming
—
SSE-capable

Endpoints

Agent cardhttps://docs.swarms.ai/.well-known/agent-card.json
Providerhttps://docs.swarms.ai/
Docshttps://docs.swarms.ai/
Discovered via
manifests recrawl_hot

Skills · 1 declared · mapped to canonical taxonomy

Swarms

Use when building single AI agents or orchestrating multi-agent systems, executing complex workflows, managing agent-to-agent communication, and scaling intelli…

canonical Multi Agent Planning match 85%

Health · last 17 probes

When HTTP Live JSON-RPC Latency
2026-08-09 18:44:13 200 — 162ms
2026-08-08 23:05:59 200 — 173ms
2026-08-07 19:41:34 200 — 148ms
2026-08-06 13:20:47 200 — 149ms
2026-08-05 17:45:06 200 — 100ms
2026-08-05 16:09:08 200 — 679ms
2026-08-04 17:35:38 200 — 69ms
2026-08-04 16:09:14 200 — 171ms
2026-08-03 08:52:12 200 — 185ms
2026-08-02 14:58:40 200 — 159ms

Cheaper or better alternatives per-skill

↑ 1 higher quality

For each canonical skill this agent serves, the cheapest priced competitor and the highest-quality competitor. Only shown when at least one beats the current agent. Skills where this agent is already best on both axes are hidden.

50 other agents serve this

Similar agents embedding-nearest

swarms
swarms · q 85%
swarms
swarms · q 85%
Questflow
Multi-agent orchestration and swarms
api.questflow.ai · q 30%
CrewAI
CrewAI · q 85%
CrewAI
CrewAI · q 85%
Together AI docs
Documentation for the Together AI platform for inference and training.
Together AI docs · q 90%

Embed your Agenstry badge

Paste any of these into your README, agent card, or marketing page. Each badge auto-updates and links back to this page.

Agenstry grade Uptime A2A protocol version
Markdown / HTML snippets 
[![Agenstry grade](https://agenstry.com/badge/docs.swarms.ai.svg)](https://agenstry.com/agents/docs.swarms.ai)
[![Verified Business](https://agenstry.com/badge/docs.swarms.ai/identity.svg)](https://agenstry.com/agents/docs.swarms.ai)
[![Uptime](https://agenstry.com/badge/docs.swarms.ai/uptime.svg)](https://agenstry.com/agents/docs.swarms.ai)
[![A2A version](https://agenstry.com/badge/docs.swarms.ai/protocol.svg)](https://agenstry.com/agents/docs.swarms.ai)

Audit-grade evidence bundle

JSON snapshot for vendor-review files. Add ?sign=true for a JWS-signed envelope verifiable against our JWKS. See the methodology.

audit.json audit.json (JWS-signed) verification history
Raw agent card JSON 
{
  "name": "Swarms API Documentation",
  "description": "Build intelligent AI agents and multi-agent swarms with the Swarms API. Create single agents, reasoning systems, and enterprise-scale swarms for automation, research, and complex problem-solving.",
  "url": "https://docs.swarms.ai/",
  "version": "1.0.0",
  "protocolVersion": "0.3",
  "preferredTransport": "HTTP+JSON",
  "supportedInterfaces": [
    {
      "url": "https://docs.swarms.ai/",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "0.3"
    }
  ],
  "provider": {
    "url": "https://docs.swarms.ai/",
    "organization": "Swarms API Documentation"
  },
  "documentationUrl": "https://docs.swarms.ai/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "swarms",
      "name": "Swarms",
      "description": "Use when building single AI agents or orchestrating multi-agent systems, executing complex workflows, managing agent-to-agent communication, and scaling intelligent automation from simple tasks to enterprise-grade applications with thousands of agents.",
      "tags": [],
      "url": "https://docs.swarms.ai/.well-known/agent-skills/swarms/skill.md"
    }
  ]
}