MCP server
MCP tools
Tools exposed by the KonvoAI MCP server for reading and acting on conversations.
All tools run with your KonvoAI identity. Organization-scoped reads and writes enforce the same membership rules as the web app (partners cannot use internal tools).
Read tools
| Tool | Description |
|---|---|
list_organizations | Organizations you belong to, with your role. |
list_conversations | Conversations in an organization; optional status (open, closed, resolved). |
get_conversation | Conversation metadata plus the full ticket event timeline for a streamId. |
list_members | Members of an organization (excluding partner and platform-admin roles). |
Write tools
| Tool | Description |
|---|---|
respond_to_conversation | Send a text reply (streamId, body; optional clientToken for idempotency). |
set_conversation_status | Set status to open, closed, or resolved. |
assign_conversation | Assign to a user or ai_agent, or pass null to clear. |
snooze_conversation | Snooze until a Unix ms timestamp, or null to unsnooze. |
pin_conversation | Pin or unpin a conversation. |
Write tools dispatch through the same server mutators as the KonvoAI web app, including billing gates and outbound send queues for replies.
Example flow
list_organizations→ pick anorganizationId.list_conversationswith{ "organizationId": "org_…", "status": "open" }.get_conversationwith{ "organizationId": "org_…", "streamId": "…" }.respond_to_conversationwith{ "streamId": "…", "body": "Thanks for reaching out!" }.
Tool results are JSON text in the MCP content payload.