# Stallo MCP server

Work with Stallo Boards from Claude Code and other MCP clients: list boards and tickets, create and update tickets,
move them between columns, and manage their todos. Every call acts as the person who owns the API key.

## Connect

1. Sign in to Stallo and create a personal API key: https://stallo.ai/app/settings/integrations (Personal API keys).
2. Add the server to your client. For Claude Code:

```
claude mcp add --transport http stallo https://mcp.stallo.ai/mcp --header "Authorization: Bearer <your key>"
```

Endpoint: `https://mcp.stallo.ai/mcp` (Streamable HTTP, POST). Authentication: `Authorization: Bearer <key>` or `x-api-key: <key>`.
Keys expire, can be revoked in Settings at any time, and can only read and change Boards.

## Tools

- `list_boards`: List the boards in the workspace.
- `list_tickets`: Show a board's columns and tickets; filter by column, label, assignee or text.
- `get_ticket`: Read a ticket with its todos, latest comments and the ways out of its column.
- `create_ticket`: Create a ticket, optionally in a column and assigned to you.
- `update_ticket`: Change title, description, priority, labels, due date or assignment.
- `move_ticket`: Move a ticket to another column.
- `add_todo`: Add a todo to a ticket.
- `complete_todo`: Mark a todo done, with a note on what was done.
- `add_comment`: Comment on a ticket: progress, questions, links to commits and merge requests.

About Stallo: https://stallo.ai
