MCP server

@getfoyer/mcp is a Model Context Protocol server. Wire Foyer into any MCP-aware agent (Claude Code, Codex, Cursor, Windsurf, …) so the agent can pull review context, plan artifacts, and blockers directly.

Run foyer login first so a token exists at ~/.foyer/credentials.

Install (Claude Code)

claude mcp add foyer \
    --scope user \
    --env FOYER_API_URL=https://api.getfoyer.dev \
    --env FOYER_TOKEN="$(jq -r .token ~/.foyer/credentials)" \
    -- npx -y @getfoyer/mcp@latest

Why the jq? Reading the token directly from the file (instead of via shell variable or copy-paste) strips any trailing newline — that newline is the -32000 MCP JSON-RPC error footgun.

If ~/.foyer/credentials is plain text instead of JSON (older CLI), swap:

--env FOYER_TOKEN="$(tr -d '[:space:]' < ~/.foyer/credentials)"

Install (generic MCP client)

{
  "mcpServers": {
    "foyer": {
      "command": "npx",
      "args": ["-y", "@getfoyer/mcp@latest"],
      "env": {
        "FOYER_API_URL": "https://api.getfoyer.dev",
        "FOYER_TOKEN": "<paste the .token field from ~/.foyer/credentials>"
      }
    }
  }
}

Verify

In Claude Code: run /mcp — foyer should show up green with the tool list. If the entry is red, see troubleshooting.