Faultline MCP server

1. Download

Source release is in the pipeline; until then, grab a pre-built binary built straight from the deploy. Version: latest.

macOS · Apple Silicon darwin-arm64 macOS · Intel darwin-amd64 Linux · x86_64 linux-amd64 Linux · ARM64 linux-arm64 Windows · x86_64 windows-amd64

macOS / Linux one-liner:

terminal

curl -fsSL https://faultline.live/mcp/install.sh | bash

2. Get an API token

The MCP server authenticates with a per-account fl_ token. Mint one at Account → API tokens after you sign in. Tokens are scoped to your account's project visibility — same as the dashboard.

3. Configure your editor

MCP-aware editors look for a server config file. Same shape across Cursor, Claude Code, and Windsurf — copy this and adjust the command path to wherever you saved the binary.

.mcp.json (Claude Code) / mcp.json (Cursor)

{ "mcpServers": { "faultline": { "command": "/usr/local/bin/faultline-mcp", "env": { "FAULTLINE_API_TOKEN": "fl_…", "FAULTLINE_BASE_URL": "https://faultline.live" } } } }

Optional: drop a .faultline.json file in any repo with a project_id field, and the MCP server will auto-scope to that project. Otherwise it tries the FAULTLINE_PROJECT_ID env var, then a git-remote lookup against your faultline projects.

4. Use it

Once your editor restarts with the config above, your agent has these tools:

list_issues — recent unresolved issues for the project
get_issue — full issue details, including resolution metadata
get_issue_context — stack trace + breadcrumbs + mobile context
list_events — most recent events for an issue (handy when one stack trace isn't enough)
mark_resolved — close out an issue after the fix lands
snooze — defer an issue with a reason
select_project — re-scope mid-session

Ask your agent something like "what's broken on faultline?" and it'll start pulling issues. From there you can have it diagnose, write a fix, run your tests, and call mark_resolved when the fix is verified.

Wire your
agent in.

1. Download

2. Get an API token

3. Configure your editor

4. Use it

Already wired in?