Skip to content

Windsurf Agent Ready Resource/checks

How to: Windsurf Agent Ready checks

client:Windsurf transport:streamable-http resource:checks

Add Agent Ready to Windsurf

  1. 01

    Open ~/.codeium/windsurf/mcp_config.json and merge this in. Keep any servers already there.

{
  "mcpServers": {
    "agent-ready-mcp": {
      "serverUrl": "https://agent-ready.dev/api/v1/mcp"
    }
  }
}
  1. 02

    Save the file and restart Windsurf.

  2. 03

    checks is surfaced wherever your client lets you attach context. It is context to attach, not an action to run.

  3. 04

    If it does not appear, check that Agent Ready is connected and that you are looking at its resources rather than its tools.

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

Set these first

Agent Ready will not start until these are set, so it never reaches Windsurf.

  • AGENT_READY_API_KEY

Same resource, other clients

Read from the server itself, by connecting to it and calling resources/list on 24 September 2026. A listing does not declare its resources, so asking is the only way to know them, and this is what the server actually offers rather than what its listing claims. Names only are stored; connect the server for each resource's type and contents.