Protocols and tools¶
Protocols¶
| Protocol | Dependency | First use | Verify | Detailed guide |
|---|---|---|---|---|
| Agent Client Protocol, ACP | Included | :connect acp <agent> | superqode agents doctor <agent> | ACP Coding Agents |
| Model Context Protocol, MCP | Included | Configure a server in superqode.yaml | :mcp doctor | MCP Configuration |
| Agent2Agent, A2A | uv tool install "superqode[a2a]" | :connect a2a or superqode connect a2a --url <url> | superqode connect a2a --conformance --json | A2A Agents |
| Unified Harness Protocol, UHP | Included | superqode connect uhp --base-url <url> | superqode connect uhp --json | Unified Harness Protocol |
| Harness Protocol | Included | superqode harness protocol list | superqode harness protocol conformance | Harness Protocol |
SuperQode can expose a harness as an MCP, ACP, or A2A service. See Serve a Harness over ACP, the MCP command, and the A2A server guide.
A2A and multiplayer computers¶
A2A is SuperQodeβs primary harness-to-harness and agent-to-agent network surface. Other agents discover SuperQode through a public Agent Card and call the interface URL advertised in that card. The public pilot answers anonymous shortlist calls. A signed key is optional and switches the request to a model read. --token is required only when a remote bind also serves the harness skill (--expose-harness).
This is the preferred way to collaborate with multiplayer agent computers such as YCβs QM: keep SuperQode as the versioned HarnessSpec, kernel, and evidence layer, and keep the multiplayer system as the org-shared computer. Do not merge runtimes; exchange tasks over A2A.
An experimental, non-product packaging sketch for running SuperQode as a tool inside a QM-style deploy directory lives at examples/qm-deployment-layer. Treat that as compatibility exploration, not official QM support. Independent TypeScript and Python A2A clients for interop checks are documented under A2A Protocol.
| First step | Command or URL |
|---|---|
| Public Agent Card | https://super-agentic.ai/.well-known/agent-card.json |
| Serve a harness over A2A | superqode serve a2a --spec harness.yaml |
| Call / discover from the TUI | :connect a2a Β· superqode connect a2a --inspect |
| Full guide | A2A Protocol |
CocoIndex Code semantic search¶
The semantic extra installs the slim CocoIndex Code client. A local Ollama embedding route avoids adding Torch or sentence-transformers to the SuperQode environment.
uv tool install "superqode[semantic]"
ollama pull nomic-embed-text
ccc init --litellm-model ollama/nomic-embed-text
ccc index
The semantic_search tool registers when CocoIndex Code is importable. Verify the index directly with ccc search "<query>", then use the tool from a SuperQode-owned harness. See Semantic Code Search.
Monty Python REPL¶
Install the sandboxed Python execution tool:
uv tool install "superqode[monty]"
superqode providers doctor
Add the Monty tool to a HarnessSpec when a model needs bounded Python calculation. See Monty Python REPL.
MCP tools and plugins¶
MCP clients and servers are included. Repository plugins can add tools, commands, hooks, and integration-specific behavior without changing the core package:
:mcp doctor
superqode plugins list
superqode plugins doctor
See MCP Configuration and Plugin Authoring.