MCP Server

Plug Architecture Into Your AI Coding Tool

The Agents But Why MCP server gives your AI assistant direct access to our full knowledge base — 7 architecture patterns and 25 real-world use cases, and detailed component breakdowns. Ask questions, get recommendations, and make architecture decisions without leaving your editor.

⚡ Quick Start

The server is live — no installation required. Add the endpoint to your AI coding tool:

https://www.agentsbutwhy.com/api/mcp

• What is MCP?

The Model Context Protocol is an open standard that connects AI assistants to external tools and data sources. Instead of copy-pasting architecture docs into your chat, MCP lets the AI read from them directly — searchable, structured, and kept in sync with this repository.

🔍

5 Tools

Search, detail, recommend

📚

4 Resources

Browse the full catalog

💬

2 Prompts

Review & compare workflows

• Available Tools

Tools are actions your AI assistant can invoke on your behalf.

search_patterns

Search architecture patterns by keyword, tag, or complexity level.

Try: "Show me patterns related to security"

get_pattern_detail

Get the full breakdown of a pattern and its related use cases.

Try: "Tell me everything about agentic-rag"

search_use_cases

Search real-world use cases by industry, complexity, or pattern.

Try: "Show me finance use cases"

get_use_case_detail

Get the full analysis of a specific use case.

Try: "Walk me through the AI Call Center use case"

recommend_architecture

Describe your project and get architecture pattern recommendations.

Try: "I'm building a customer support chatbot that needs to query our knowledge base..."

• Browsable Resources

Resources are data your AI assistant can read for context.

agentsbutwhy://patternsBounded catalog of architecture patterns in the Agents But Why knowledge base.

agentsbutwhy://patterns/{slug}Full detail of a specific architecture pattern.

agentsbutwhy://use-casesBounded catalog of real-world use cases.

agentsbutwhy://use-cases/{slug}Full analysis of a specific use case.

• Guided Prompts

Prompts are reusable workflows discovered directly from the MCP server.

🏗️

architecture_review

Describe your project and get a structured review with pattern recommendations and trade-off analysis.

⚖️

pattern_comparison

Compare two or three patterns side by side — strengths, weaknesses, and when to choose each.

• Connect Your Tool

⌨️

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "agents-but-why": {
      "url": "https://www.agentsbutwhy.com/api/mcp"
    }
  }
}

🤖

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "agents-but-why": {
      "url": "https://www.agentsbutwhy.com/api/mcp"
    }
  }
}

🚀

Antigravity

mcp_config.json

{
  "mcpServers": {
    "agents-but-why": {
      "serverURL": "https://www.agentsbutwhy.com/api/mcp"
    }
  }
}

🔌

Any MCP Client

MCP settings

Server URL: https://www.agentsbutwhy.com/api/mcp
Transport:  Streamable HTTP

• How It Works

Add the endpoint

Copy the MCP server URL into your AI tool's settings.

Your AI connects

Your assistant discovers 5 tools, 4 resources, and 2 prompts directly from the server.

Ask about architecture

Your assistant now has direct access to 7 architecture patterns and 25 real-world use cases and their detailed component breakdowns.

The MCP server and this page now use the same repository-backed capability registry and content catalog.