How do I use agentic-patterns?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agentic-patterns find a pattern for autonomous subtask delegation" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-agentic-patterns

An MCP (Model Context Protocol) server that exposes the Agentic Patterns Catalog — patterns, compositions (recipes + frameworks), methodologies, anti-patterns and code examples — as resources and tools for AI coding agents like Claude Code, Cursor, Cline and Claude Desktop.

Catalog data is sourced from https://github.com/agentpatternscatalog/patterns.

Run it locally (today)

git clone https://github.com/agentpatternscatalog/mcp.git
cd mcp
uv sync                      # or: python -m venv .venv && pip install -e .
uv run mcp-agentic-patterns  # stdio transport (default)

The first run downloads the catalog tarball from github.com/agentpatternscatalog/patterns into ~/.cache/mcp-agentic-patterns/patterns-main/ and reuses it on subsequent runs. No network needed after the first start.

Refresh the cached catalog:

uv run mcp-agentic-patterns --refresh-catalog
# or:  MCP_CATALOG_REFRESH=1 uv run mcp-agentic-patterns

Point at a local checkout instead (skips the network entirely):

uv run mcp-agentic-patterns --catalog-dir /path/to/agent-patterns-catalog
# or:  CATALOG_DIR=/path/to/agent-patterns-catalog uv run mcp-agentic-patterns

Resolution priority: --catalog-dir arg → CATALOG_DIR env → sibling ../agent-patterns-catalog/ checkout → on-disk cache → fresh GitHub fetch → bundled package data.

Wire it into your MCP client

Claude Desktop, Claude Code, Cursor, Cline (and other MCP clients) all read a mcpServers config block. Point them at the local checkout:

{
  "mcpServers": {
    "agentic-patterns": {
      "command": "uv",
      "args": [
        "--directory", "/abs/path/to/mcp",
        "run", "mcp-agentic-patterns"
      ]
    }
  }
}

Or, after pip install -e .:

{
  "mcpServers": {
    "agentic-patterns": {
      "command": "mcp-agentic-patterns"
    }
  }
}

HTTP transport

For non-stdio MCP clients, run the server over streamable-HTTP:

uv run mcp-agentic-patterns http --host 0.0.0.0 --port 8080

Tools

Tool	What it does
`find_pattern(query, limit?)`	Fuzzy search across name, alias, intent
`get_pattern(id)`	Full pattern body
`list_patterns(category?)`	Enumerate patterns, optionally by category
`get_pattern_context(id)`	Reverse-index view: who implements it, who uses it, what opposes it
`examples_for(pattern_id, framework?)`	Code examples for a pattern
`pattern_for_symptom(symptom)`	Given an observed symptom, suggest anti-patterns + fix patterns
`anti_patterns_in(category?)`	List anti-patterns
`get_recipe(id)` / `get_framework(id)` / `list_frameworks(category?)`	Composition lookups
`get_methodology(id)`	Methodology entry
`recommend_recipe(use_case, scale?, regulated?)`	Heuristic recommender

Resources

URI	Body
`pattern://<id>`	Pattern entry as JSON
`recipe://<id>`	Recipe entry as JSON
`framework://<id>`	Framework entry as JSON
`methodology://<id>`	Methodology entry as JSON

Develop

uv sync
uv run pytest tests

The smoke tests look for a sibling ../agent-patterns-catalog/ checkout if CATALOG_DIR isn't set; otherwise they exercise the cached / GitHub-fetched copy.