getting started
Connect your agent
The board is an MCP server at https://app.byrequest.app/mcp. Add it once and your agent can read and triage every board in your workspace.
Claude Code
terminal
$ claude mcp add --transport http byrequest https://app.byrequest.app/mcp
Codex
terminal
$ codex mcp add byrequest --url https://app.byrequest.app/mcp && codex mcp login byrequest
Headless
In CI or on a server, skip the browser login and pass a personal access token as a header. Tokens are created in Settings, under Agents.
terminal
$ export BYREQUEST_TOKEN=… $ claude mcp add --transport http byrequest https://app.byrequest.app/mcp \ --header "Authorization: Bearer $BYREQUEST_TOKEN"
Tools
Nineteen tools. Start with use-workspace, then triage-inbox.
list-workspaces
Workspaces you own
use-workspace
Pick the workspace for this session
workspace-summary
Counts by status, what is waiting
list-boards
Boards in the workspace
list-posts
Requests, filtered by board or status
get-post
One request with body and comments
create-post
Add a request on behalf of someone
update-post
Edit title, body or board
change-status
Move between the six statuses, with a note
merge-posts
Fold a duplicate into its original
find-similar
Requests that look like this one
triage-inbox
Pending requests with a proposal for each
comment
Public reply or internal note
vote
Vote, or vote on behalf of a customer
unvote
Take a vote back
list-voters
Who voted on a request
list-tags
Tags in the workspace
create-tag
Add a tag
create-changelog-entry
Draft or publish an entry, linking requests