MCP tokens reference
Technical reference for Boki MCP server tokens
Technical specification for Boki's MCP server and personal access tokens.
Boki supports two authentication methods for MCP clients:
- OAuth — For ChatGPT and Claude. See How to connect ChatGPT or Claude.
- Personal access tokens (PAT) — For Cursor and clients that need a Bearer token. Documented below.
| Property | Value |
|---|
| URL | https://app.boki.io/api/mcp |
| Protocol | MCP (Model Context Protocol) |
| Authentication | Bearer token |
boki_pat_[unique_identifier]
Tokens always start with the boki_pat_ prefix.
| Property | Value |
|---|
| Prefix | boki_pat_ |
| Length | Variable |
| Character set | Alphanumeric |
| Case sensitive | Yes |
| Expiration | 30 days from creation |
- Tokens are shown once at creation
- Boki does not store the full token after display
- Tokens cannot be retrieved after creation
- Tokens can be revoked at any time
The MCP server exposes approximately 54 tools across these scopes:
| Tool | Operation |
|---|
| get_article | Retrieve article by ID |
| list_articles | List articles with filters |
| post_article | Create new article |
| update_article | Update existing article |
| delete_article | Delete article |
| export_article_markdown | Export article as Markdown |
| Tool | Operation |
|---|
| get_brief | Retrieve brief by ID |
| list_briefs | List briefs with filters |
| post_brief | Create new brief |
| update_brief | Update existing brief |
| delete_brief | Delete brief |
| Tool | Operation |
|---|
| get_plan | Retrieve plan by ID |
| list_plans | List plans with filters |
| create_plan | Create new plan |
| update_plan | Update existing plan |
| delete_plan | Delete plan |
| Tool | Operation |
|---|
| get_social_post | Retrieve social post by ID |
| list_social_posts | List social posts with filters |
| create_social_post | Create new social post |
| update_social_post | Update existing social post |
| delete_social_post | Delete social post |
| list_social_connections | List connected social accounts |
The UI calls this feature "Promotions"; the MCP tools retain the distribution naming.
| Tool | Operation |
|---|
| get_distribution | Retrieve promotion by ID |
| list_distributions | List promotions with filters |
| create_distribution | Create new promotion |
| update_distribution | Update existing promotion |
| delete_distribution | Delete promotion |
| Tool | Operation |
|---|
| get_shortlink | Retrieve short link by ID |
| list_shortlinks | List short links with filters |
| create_shortlink | Create new short link |
| update_shortlink | Update existing short link |
| delete_shortlink | Delete short link |
| Tool | Operation |
|---|
| get_expert | Retrieve expert by ID |
| list_experts | List experts with filters |
| create_expert | Create new expert |
| update_expert | Update existing expert |
| delete_expert | Delete expert |
| Tool | Operation |
|---|
| get_insight | Retrieve insight by ID |
| list_insights | List insights with filters |
| create_insight | Create new insight |
| update_insight | Update existing insight |
| delete_insight | Delete insight |
| Tool | Operation |
|---|
| create_mdx_component | Create MDX component |
| delete_mdx_component | Delete MDX component |
Inline comments can be added and listed across articles, briefs, and plans.
| Tool | Operation |
|---|
| add_article_inline_comment | Add inline comment to article |
| list_article_comments | List comments on an article |
| add_brief_inline_comment | Add inline comment to brief |
| list_brief_comments | List comments on a brief |
| add_plan_inline_comment | Add inline comment to plan |
| list_plan_comments | List comments on a plan |
| Tool | Operation |
|---|
| get_workspace_context | Get workspace context |
| get_brand_voice | Get brand voice settings |
| update_brand_voice | Update brand voice |
| ensure_brand_voice | Ensure brand voice exists |
Include the token in the Authorization header:
Authorization: Bearer boki_pat_xxxxxxxxxxxx
| Status | Meaning |
|---|
| 401 | Token missing or invalid |
| 403 | Token valid but insufficient permissions |
| 410 | Token expired or revoked |
Rate limits apply per token. Limits vary by plan tier.