Skip to content
MCP server

microservice.md

Coding agents read service docs, contracts and dependents from a microservice.md catalog

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.microservice.md/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "catalog": {
      "url": "https://mcp.microservice.md/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools