Prozari MCP Server
Drive your Prozari workspace from Claude Code, Cursor, Codex, Continue and any other AI client that speaks the Model Context Protocol. 16 tools live, covering boards, cards and the full social-scheduler approval lifecycle.
Install
No clone, no build step. Most MCP clients fetch and cache the package on first run via npx, so the only thing you install locally is Node 18+.
# verify the package is reachable (optional)
npx -y @prozari/mcp-server --help
# or pin a version in your client config
@prozari/mcp-server@0.2.0Prefer to build from source? The repo lives on Azure DevOps — git clone, npm install, npm run build, then point your client at dist/index.js.
Configure
Three environment variables. Only PROZARI_TOKEN is required.
| Variable | Required | Purpose |
|---|---|---|
| PROZARI_TOKEN | required | A pzr_… API token from Settings → API tokens (recommended). Legacy JWTs also accepted. |
| PROZARI_API_BASE | optional | Defaults to https://api.prozari.com/api. |
| PROZARI_WORKSPACE_ID | optional | Default workspace so tools don't need it on every call. |
| PROZARI_BOARD_ID | optional | Default board so list_lists / create_card use it by default. |
Recommended — pzr_ tokens
Mint one at Settings → API tokens. Tokens inherit your UI permissions, so removing yourself from a board removes the token's access too — no separate revocation step. The legacy JWT path (24h expiry) still works for smoke tests.
Wire it into your AI client
Claude Code
claude mcp add prozari -- npx -y @prozari/mcp-server
# in ~/.zshrc or ~/.bashrc
export PROZARI_TOKEN="eyJhbGciOiJIUzI1NiIs…"
export PROZARI_WORKSPACE_ID="cmd…"
export PROZARI_BOARD_ID="cmd…"Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"prozari": {
"command": "npx",
"args": ["-y", "@prozari/mcp-server"],
"env": {
"PROZARI_TOKEN": "eyJhbGciOiJIUzI1NiIs…",
"PROZARI_WORKSPACE_ID": "cmd…"
}
}
}
}Codex / OpenAI tools
Codex follows the same MCP spec — same command: "npx" + args: ["-y", "@prozari/mcp-server"]shape. Consult OpenAI's MCP docs for the exact config path.
Tools (16)
Discovery
| Name | Purpose |
|---|---|
| list_workspaces | List workspaces the user belongs to |
| list_boards | List boards in a workspace |
| list_lists | List columns on a board with card counts |
| get_default_target | Echo the configured default workspace + board IDs |
Cards
| Name | Purpose |
|---|---|
| create_card | Create a card; supports markCompleted: true for log-what-I-just-did flows |
| update_card | Patch title / description / priority / dueDate / points |
| move_card | Move to a different list; auto-sets completedAt on Done lists |
| complete_card | Flip the Mark-Complete toggle; respects workspace auto-archive policy |
| list_my_cards | Cards assigned to the authenticated user; filter today / overdue / this-week |
| add_comment | Add a comment to a card with @mention support |
Social
| Name | Purpose |
|---|---|
| list_social_accounts | Discover connected FB Pages, IG Business accounts, LinkedIn orgs |
| list_social_posts | List posts by workspace, optionally filtered by status / date range |
| create_social_post | Create a post; status derived per workspace approval policy |
| approve_social_post | Admin approves a PENDING_APPROVAL post |
| reject_social_post | Admin rejects a pending post with optional reason |
| get_social_analytics_summary | Trailing-30-day workspace summary: totals + per-platform + top posts |
Example prompts
Real things you can say to Claude / Cursor / Codex once the server is wired up:
| Prompt | Tool call chain |
|---|---|
| "Add this fix as a completed card on the Atlas Bills board, priority high" | list_lists → create_card({ markCompleted: true }) |
| "What's on my plate today?" | list_my_cards({ scope: 'today' }) |
| "Move TASK-L8NV to Done" | list_lists → move_card |
| "Draft a LinkedIn post about today's launch, link it to this card" | list_social_accounts → create_social_post({ cardId }) |
| "What posts are waiting for my approval?" | list_social_posts({ status: 'PENDING_APPROVAL' }) |
| "Approve all pending posts from Sam" | list_social_posts → loop approve_social_post |
| "Give me the social numbers for the last 30 days" | get_social_analytics_summary |
Roadmap
- v0.2.0 (current) — 16 tools; PROZARI_TOKEN accepts workspace-scoped
pzr_tokens with no 24h rotation; legacy JWT still works. - v0.2 (Phase E, Q3 2026) — workspace-scoped API tokens, rate limiting, npm publish, wiki tools (
create_wiki_page/update_wiki_page),link_pr_to_card. - v0.3 — Claude Code skill manifest (one-click install), auto-token-refresh, streaming responses for long list calls.