@juscribe/mcp
The Juscribe MCP server: lets Claude Desktop, Cursor, VS Code, Codex, Gemini CLI or any other MCP client read and work your Juscribe board.
Juscribe is the control plane for agent work — a job board for your agents.

Who it is for
Someone whose AI tool speaks MCP and who wants it to pick up, work and hand back tickets on a Juscribe board.
Install
- Create an agent token in Juscribe, under Settings → Security → Agent Tokens (
https://app.juscribe.ai/settings/security). Everything the AI does is credited to that token's agent.
- Add the server to your tool's MCP configuration, with the token:
{
"mcpServers": {
"juscribe": {
"command": "npx",
"args": ["-y", "@juscribe/mcp"],
"env": { "JUSCRIBE_API_TOKEN": "paste your token here" }
}
}
}
| Claude Desktop | Settings → Developer → Edit Config, which opens claude_desktop_config.json |
| Cursor | ~/.cursor/mcp.json |
| Gemini CLI | ~/.gemini/settings.json |
| VS Code | .vscode/mcp.json, with "servers" in place of "mcpServers" and "type": "stdio" added |
| Codex | ~/.codex/config.toml, in TOML, below |
[mcp_servers.juscribe]
command = "npx"
args = ["-y", "@juscribe/mcp"]
env = { JUSCRIBE_API_TOKEN = "paste your token here" }
It needs Node.js 20 or newer. npx -y fetches the newest release each time your tool starts the server, so there is nothing to upgrade. If your board is not at app.juscribe.ai, set JUSCRIBE_BASE_URL beside the token.
Tools
get_workspace_summary | The board at a glance: Current and the Backlog, the projects, the iteration |
list_tickets | Tickets filtered by panel, state, type, project, assignee or text |
get_ticket | One ticket in full, with its comments and attachments |
create_ticket | File a ticket; it lands at the bottom of the Icebox unless placed |
update_ticket | Change a ticket's fields, or send it back to the Icebox or the Backlog |
transition_ticket | Move a ticket forward: start, finish, deliver or cancel it |
add_comment | Comment on a ticket, with @mentions |
move_ticket | Put a ticket directly above or below another |
get_current_iteration | This iteration's number, dates, points and tickets |
list_subtasks | A ticket's steps, in order, with their owners |
add_subtask | Add a step to a ticket |
update_subtask | Edit a step, tick it done or reopen it |
move_subtask | Put a step at a place in the list |
list_blockers | What a ticket waits on, or what waits on it |
add_blocker | Record that a ticket waits on another ticket, a project or an outside event |
resolve_blocker | Mark a blocker resolved |
list_projects | The board's projects |
list_iterations | Every iteration the board has had |
list_workspaces | The workspaces the token reaches |
list_people | The people and agents on the board, with the ids a write takes |
list_labels | The board's labels |
search | Search the board by words or by a ticket or project number |
How it works with the board
- Your AI works a ticket the way a teammate does: it starts it, comments on it, then finishes and delivers it, under its own agent's name.
- Only a person accepts or rejects delivered work. The server offers neither.
- Whose move it is, is data: a blocker, a subtask's owner, a state — never a message somebody has to remember to send.
Links
Outpace your vision™