
microservice.md
Coding agents read service docs, contracts and dependents from a microservice.md catalog
- Pricing
- Free
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 2 days ago
About microservice.md
microservice.md is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
The server is built for one habit: look before you edit. Before touching an event or endpoint, an agent can ask who consumes it, with team and contact for each publisher and subscriber, or which services depend on a service, either synchronously with the endpoints they call when recorded, or through events. It can also fetch a neighbour's generated contract, such as OpenAPI, AsyncAPI, proto, GraphQL, runbook, ADRs and C4 files, before writing code that calls it.
A repo links itself to the catalog through a Catalog ID line in the MICROSERVICE.md at its root, so the agent knows which service it is working on. Without it, the agent lists services and asks. Two ready-made prompts are included, one of them an impact check that shows as a slash command in Claude Code.
This first version is read-only, answers only from the last saved version of each service and says when unsaved edits exist, and covers only services you own. Every call is authenticated: OAuth for coding agents and an API key for CI, with agents you can disconnect from Settings. The server is stateless, so a script can send a single tools/call.
Install
Run in a terminal
claude mcp add --transport http catalog https://mcp.microservice.md/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.microservice.md/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"catalog": {
"url": "https://mcp.microservice.md/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"catalog": {
"type": "http",
"url": "https://mcp.microservice.md/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"catalog": {
"serverUrl": "https://mcp.microservice.md/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"catalog": {
"type": "http",
"url": "https://mcp.microservice.md/mcp"
}
}
}Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- list_services
- Lists catalog services with ID, name, mission, team and saved version.
- get_service_md
- Returns a service's MICROSERVICE.md from a saved version.
- list_artifacts
- Lists generated files such as OpenAPI, AsyncAPI, proto, GraphQL, runbook, ADRs and C4.
- get_artifact
- Gets one generated file for a service or its dependency.
- find_event_consumers
- Finds publishers and consumers of an event with team and contact.
- find_dependents
- Finds services that depend on a service, synchronously or through events.
What it does
- Catalog listing
- Lists services with ID, name, mission, team and saved version.
- Service document
- Reads a service's MICROSERVICE.md from a saved version.
- Generated contracts
- Fetches OpenAPI, AsyncAPI, proto, GraphQL, runbook, ADRs and C4 files.
- Event consumer lookup
- Shows who publishes and consumes an event, with team contact.
- Dependent lookup
- Finds services that depend on another, directly or via events.
- CI access
- API keys let pipelines call the server without a browser sign-in.
Good for
- Check who consumes an event before adding a field to it
- See what depends on an endpoint before changing it
- Generate a client from a neighbour service's OpenAPI file
- Have an agent summarise what a service owns before editing it
- Script catalog queries from a CI pipeline
Pricing
Free
Free during beta
Prices change. Check microservice.md before you buy.
microservice.md FAQ
Do I need an account?
Yes. You need a microservice.md account with at least one saved service; there is no anonymous access.
Can the agent change the catalog?
No. This version is read-only; edits go through microservice.md.
How does the agent know which service a repo is?
Through the Catalog ID line in the MICROSERVICE.md at the repo root.
Does it see services shared with me?
Not yet; it covers services you own.
How do I add it to Claude Code?
Run claude mcp add --transport http microservice-md https://mcp.microservice.md/mcp, then authenticate from /mcp.
Is microservice.md free?
Yes. microservice.md is free to use.
How do I add microservice.md to Claude Code?
Run this command in your terminal: claude mcp add --transport http catalog https://mcp.microservice.md/mcp
What are the best alternatives to microservice.md?
The closest alternatives to microservice.md are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to microservice.md

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools