Feedback Layer MCP

Feedback Layer MCP exposes selected project feedback requests to coding agents. It runs as a local stdio MCP server and talks to your Feedback Layer API over HTTPS with a personal access token.

Quick Start

npx -y @mathlab7/feedback-layer-mcp@latest init

The init command stores credentials in:

~/.config/feedback-layer/auth.json

It also writes local MCP client configuration for Claude-style .mcp.json and Codex ~/.codex/config.toml.

Standard MCP Config

{
  "mcpServers": {
    "feedback-layer": {
      "command": "npx",
      "args": ["-y", "@mathlab7/feedback-layer-mcp@latest"]
    }
  }
}

Codex

codex mcp add feedback-layer npx "@mathlab7/feedback-layer-mcp@latest"
npx -y @mathlab7/feedback-layer-mcp@latest init

Or edit ~/.codex/config.toml:

[mcp_servers.feedback-layer]
command = "npx"
args = ["-y", "@mathlab7/feedback-layer-mcp@latest"]

Claude Code

claude mcp add feedback-layer npx @mathlab7/feedback-layer-mcp@latest
npx -y @mathlab7/feedback-layer-mcp@latest init

Cursor, Windsurf, VS Code and Other Clients

Use the standard MCP config above. Feedback Layer uses stdio transport, so the client starts the package locally with npx.

Non-Interactive Setup

npx -y @mathlab7/feedback-layer-mcp@latest init \
  --url https://feedback-layer.venture-ia.com \
  --token flp_live_xxx \
  --project findy

Environment-only configuration also works:

FL_API_BASE_URL=https://feedback-layer.venture-ia.com \
FL_PROJECT_SLUG=findy \
FL_TOKEN=flp_live_xxx \
npx -y @mathlab7/feedback-layer-mcp@latest

Commands

feedback-layer-mcp init
feedback-layer-mcp doctor
feedback-layer-mcp status

The short alias fl-mcp is also available.

Tools

• list_tasks - list ready tasks for the configured project
• get_task - read one task with implementation prompt and acceptance criteria
• claim_task - claim a task for the current local session
• complete_task - mark a claimed task complete with a PR URL
• release_task - release a claimed task back to the ready queue

Security

Do not commit tokens or generated client config. Keep .mcp.json local when it contains environment secrets. Prefer init, which stores the token in a user-local file with 0600 permissions.