Warp configures MCP servers through its app UI and reads project rules from an all-caps AGENTS.md at the project root (or WARP.md for the legacy convention).
Warp does not read MCP config from a file in your repo. Instead, register the contextception MCP server through the Warp UI:
- Open Settings → Agents → MCP servers (or run Open MCP Servers from the command palette).
- Click + Add and choose CLI command.
- Configure:
- Name:
contextception - Command:
contextception - Args:
mcp
- Name:
- Save and restart the agent panel.
Once registered, the contextception tools are available across every Warp Agent session, not just one project.
Either run contextception setup --instructions from inside your project (it appends a marker-fenced block to existing AGENTS.md files, leaves your other rules alone, and is idempotent on re-runs), or copy ../AGENTS.md verbatim to your project root as:
AGENTS.md
Note: Warp requires the filename to be in all caps — AGENTS.md is recognized, agents.md is not. Warp also still honors the legacy WARP.md convention if you're migrating from one. Subdirectory-level AGENTS.md files are merged automatically with the project-root one.