---
schema: formation.service/v0.1
kind: service
canonicalizer_version: formation-canonical/v1
name: 'Topology Index'
private_auth:
  - scoped_bearer_credential
private_mcp:
  - local_stdio_bridge
product_api_version: v1
supported_schemas:
  - formation.policy/v0.1
  - formation.execution_lock/v0.1
  - formation.workload_profile/v0.1
  - formation.suite/v0.1
  - formation.evaluation_plan/v0.1
  - formation.job_status/v0.1
  - formation.run/v0.1
  - formation.evidence/v0.1
  - formation.decision/v0.1
  - formation.adoption/v0.1
  - formation.subscription/v0.1
  - formation.error/v0.1
  - formation.service/v0.1
  - formation.account_status/v0.1
  - formation.recommendation_request/v0.1
  - formation.evaluation_plan_request/v0.1
  - formation.comparison_request/v0.1
  - formation.policy/v0.2
supported_workloads:
  - coding.bugfix
---

# Topology Index

Topology Index is a reference, written for AI agents, to multi-agent topologies: the
orchestration patterns that decide how LLM agents divide, check and coordinate work, such as
orchestrator-worker supervisors, planner-executor pairs, evaluator-optimizer critic loops,
map-reduce, fan-out, routers, debate, councils, blackboards, swarms and handoffs.

A pattern is one named building block. A topology is the whole arrangement of roles, control
flow and shared state for a task. A formation is a versioned `FORMATION.md` policy file that
declares a topology so an agent can run it and report the outcome.

Nothing here ranks patterns. Evidence attaches to a complete execution configuration on a
stated workload, and no public evidence is published yet; the pattern pages say what each
arrangement is, when it is hypothesised to fit and what to watch for.

## Start here

- [Pattern catalogue and decision guide](/patterns/index.md): choose a topology for a task
- [Starter formations](/starters/index.md): unvalidated formations to copy and register privately
- [Research records](/research/index.md): the reports behind the arrangements
- [Integration guide](/docs/api/integration.md): how an agent uses this service
- [Signed public formations](/formations/index.md): none published yet; see the starters
- [llms.txt](/llms.txt): compact machine-readable index of every page
- [Contract directory](/docs/index.md): API and schema contracts
- [Status](/status.md): service status

The same public pages are also served over MCP: `POST https://topologyindex.com/mcp` is a
public, read-only, stateless remote MCP server (Streamable HTTP, no credential) with `search`,
`fetch`, `list_patterns`, `get_pattern` and `list_starters` tools. Its answers are these
Markdown documents, byte for byte. It has no recommendation tool.

Everything here is raw Markdown with typed frontmatter; there is no HTML surface or browser
login. Private routes live under `/v1/tenants/{tenant_id}` and need a scoped bearer
credential.
Knowing an identifier or digest is never authorization.