feat: add A2A Agent Card for Swarm discovery#803
Open
crtahlin wants to merge 6 commits into
Open
Conversation
Deploy an A2A protocol Agent Card at /.well-known/agent-card.json following the A2A spec (Linux Foundation). Enables programmatic discovery of Swarm's storage capabilities by other AI agents. Describes 12 skills: upload/download data and files, feeds, postage stamp lifecycle, and upload progress monitoring. Static card only — no live agent service endpoint. The card advertises capabilities available via the swarm-mcp toolset. Refs: ethersphere/DevRel#831
✅ Deploy Preview for test-twitter-preview-testing-3 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Point agents to the swarm-mcp repo (how to set up tooling) and llms.txt (machine-readable documentation) so discovery leads to action.
Add discovery path: agents reading llms.txt can find the A2A agent card and the swarm-mcp repo, closing the loop from docs → capabilities → tooling.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds an A2A protocol Agent Card at
/.well-known/agent-card.jsonand links it fromllms.txt, enabling AI agents to discover Swarm's storage capabilities.What this is: Level 1 — a static discovery card. Agents learn what Swarm can do, where to find docs, and where to get the MCP server to actually use it.
What this is NOT: A live A2A agent endpoint. There is no hosted service that agents can call directly. Using Swarm's capabilities requires the operator to set up swarm-mcp locally. A hosted endpoint is out of scope for now.
Agent discovery flow
llms.txt→ finds agent card URL and swarm-mcp repo link/.well-known/agent-card.json→ learns 12 skills Swarm supportsChanges
static/.well-known/agent-card.json— A2A v0.3.0 card with 12 skills, provider info, links to MCP repo and llms.txtstatic/llms.txt— added references to agent card and swarm-mcp repoRefs: ethersphere/DevRel#831
Test plan
npm run buildsucceeds, file present inbuild/.well-known/agent-card.jsonhttps://docs.ethswarm.org/.well-known/agent-card.jsonafter deploy