Agent Architects MCP

Search Agent Architects lessons, posts, comments, and member profiles directly from your AI client.

This is a read-only remote MCP server. It lets compatible clients query the Agent Architects knowledge base, but it cannot change your Skool account, post on your behalf, or modify the community.

Quick Install

Get your Agent Architects MCP key from the pinned community post or setup lesson inside Agent Architects. Do not paste your key into public GitHub issues.

{
  "mcpServers": {
    "agent-architects": {
      "url": "https://aa-mcp-server-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_AA_MCP_KEY>"
      }
    }
  }
}

Restart your MCP client after saving the config.

Related MCP server: @reposit-bot/reposit-mcp

Supported Clients

• Claude Desktop

• Claude Code

• Cursor

• Windsurf

• Any client that supports remote HTTP MCP servers with bearer headers

Client-specific guides:

• Claude Desktop

• Claude Code

• Cursor

• Windsurf

Tools

• search_knowledge_base: broad semantic search across lessons, posts, comments, and member profiles.

• get_lesson: exact classroom lesson lookup by course, lesson, or lesson id.

• search_members: find members by niche, skill, role, or background.

• get_member: exact member lookup by handle or name.

Full tool guide: docs/tools.md

Try These Prompts

Search Agent Architects for lessons about evals and testing agents.

Get the Claude Code Fundamentals lesson on context engineering.

Who in Agent Architects is good with sales?

Find posts or comments about Windows setup issues with CortextOS.

Which members should I meet if I run a marketing agency and want to implement AI?

More examples: examples/prompts.md

Production Endpoints

• MCP: https://aa-mcp-server-production.up.railway.app/mcp

• Health: https://aa-mcp-server-production.up.railway.app/health

• Version: https://aa-mcp-server-production.up.railway.app/version

Notes

• This is read-only.

• The corpus refresh is not real time. Brand-new posts, comments, lessons, or member updates may lag.

• The public repo never contains the real shared community key.

• The current launch access model uses one shared Agent Architects community key.

Local Development

npm ci
npm run typecheck
npm run build

Run locally:

cp .env.example .env
# fill required values
npm run dev

Run production smoke tests:

AA_MCP_TEST_KEY=<YOUR_AA_MCP_KEY> npm run test:production-smoke

Deployment

The production service is hosted on Railway. See docs/deployment.md.

Troubleshooting

See docs/troubleshooting.md.

Security

Do not post API keys, bearer tokens, Supabase credentials, Railway tokens, or OpenAI keys in GitHub issues. See SECURITY.md.