Skip to main content

alphaswarm-mcp

Catalog date: 2026-06-24.

The alphaswarm-mcp service provides a Platform Context MCP surface for the AlphaSwarm platform. It complements the operational MCPs (Data, Codebase, ML, Docs) by providing context material that agents and developers need to work on the platform.

Role​

  • Governance Access: Provides read-only access to AGENTS.md, WORKFLOW.md, and other governance files.
  • Rules & Skills: Serves Cursor rules (.mdc files) and skill procedures.
  • Index Lookup: Provides symbol/module lookup from alphaswarm_index.
  • Spec Library: Serves YAML spec entries and schema hints.

MCP Surface​

  • Canonical URI: https://api.alpha-swarm.ai/mcp/platform
  • Resource Types: governance://, rules://, skills://, agents-md://, index://, specs://.
  • Tools: platform.search_context, platform.get_rule, platform.get_skill, platform.code_index_lookup, platform.list_mcp_servers.

Architecture​

alphaswarm_mcp/
├── src/alphaswarm_mcp/
│   ├── server.py           # FastAPI + stdio entrypoints
│   ├── auth/               # RFC 9728/8707 validation
│   ├── catalog/            # Bundle management
│   ├── resources/          # MCP resource providers
│   └── tools/              # MCP tool implementations

Hard Boundaries​

  1. Read-only: Context-only, no mutations or database writes.
  2. No Secrets: Zero secrets in resources or responses.
  3. No alphaswarm.* Imports: Decoupled from the monolith; uses alphaswarm_core primitives.

Repository​