Lean MCP: Faster Agent Connections for Claude Code and Codex
Raq.com now has a lean MCP endpoint built for coding agents and long-running assistants. Claude Code, Codex, and any MCP-compatible client can connect without loading the full tool catalogue into context up front.
A Smaller Starting Point
Raq.com exposes tools across modules like Task Board, CRM, Page Watch, Secure Send, and Automations. The full MCP tool list grows with the platform.
Lean MCP changes that starting point. Instead of advertising every tool, the agent sees a compact gateway: list enabled modules, search for a tool, fetch one schema, then call it.
Progressive Discovery
The endpoint matches the way agents like to work. When the assistant knows the tool name, it calls directly. When it knows the job, it searches, inspects one schema, then makes a targeted call.
- Smaller context. Agents start with a handful of gateway tools, then expand into the modules they need.
- On-demand schemas. The assistant loads the exact schema once it has chosen a likely tool.
- Tidier large results. Broad calls return narrowing guidance to keep the conversation focused.
- Same Raq.com account model. Permissions, accounts, and enabled modules still decide what the assistant can access.
Built For Claude Code And Codex
Claude Code and Codex work best with a precise tool surface. A focused set of schemas keeps the prompt clear when finding one board, one page monitor, or one secure link.
With Lean MCP, they discover the Raq.com workspace like a person would: see which modules are enabled, search for the action, check the arguments, then make the smallest useful call.
Large Results Stay Tidy
Workspace tools can return rich, nested data: boards, lists, cards, notes, attachments, history. Lean MCP keeps that flow smooth.
For broad calls, the endpoint guides the agent to narrow first. For larger results, the response returns suggested next calls, filters, limits, and summary options to keep the conversation focused.
How To Switch From The Existing MCP Endpoint
Existing connections continue to work. The full endpoint stays available for clients that want the complete catalogue up front. For Claude Code, Codex, and other agent-style clients, use the lean endpoint.
- Open Raq.com and go to Settings, then AI Connections.
- Choose the Agent Lean MCP connection option.
- Copy the lean MCP server URL. It ends with /mcp/agent/v1.
- In your MCP client, replace the old server URL that ended with /mcp/v1.
- Reconnect or re-authorise when your client asks. OAuth clients usually treat the new URL as a separate server.
- Test the connection. A lean setup should list the gateway tools, including raq_search_tools, raq_get_tool_schema, and raq_call_tool.
You can keep the old connection in place. Keep the full endpoint where it is useful, and add the lean endpoint for agent clients where context size and fast discovery matter.
When To Use Each Endpoint
Use Lean MCP for coding agents, long-running assistants, and workflows where the model should choose tools progressively. Use the full MCP endpoint when a client wants every available tool loaded at connection time.
If you are creating custom keys for specific agents and picking exactly which tools each agent can use, the full endpoint is usually the better fit. The tool list is already small, so handing the client the approved tools up front is clear and efficient.
Both endpoints reach the same Raq.com modules. The difference is how much the assistant needs to know before it starts working.
Get Started
Open AI Connections, pick Agent Lean, and connect Claude Code, Codex, or another MCP-compatible assistant. The assistant gets a cleaner start, and your Raq.com tools stay available without turning the catalogue into the conversation.