Capabilities
MCP Tool Catalog
A comprehensive listing of all tools exposed by the SyncFlo MCP server. Each tool maps directly to a REST API endpoint and respects matching key scopes.
REST API Parity
Every tool in the catalog matches an operation documented in the REST API reference. Need the exact payload schemas? Check the Endpoints reference page.
Read-Only Tools
| Tool Name | Required Scope | Description |
|---|---|---|
list_leads | leads:read | List leads (filter by tag, paginated) |
get_lead | leads:read | Get a single lead |
list_conversations | conversations:read | List WhatsApp conversations |
get_conversation | conversations:read | Get a single conversation |
get_conversation_messages | conversations:read | Messages in a conversation (cursor pagination) |
list_campaigns | campaigns:read | List campaigns (paginated) |
get_campaign | campaigns:read | Get a single campaign |
list_orders | orders:read | List orders (filter by status) |
search_products | catalogue:read | Search the product catalogue |
list_knowledge_sources | knowledge:read | List knowledge base sources |
list_agents | agents:read | List AI agents |
get_agent | agents:read | Get a single agent |
get_analytics | analytics:read | Account analytics summary |
get_usage | valid key | Usage stats + subscription |
whoami | valid key | Key identity, scopes, permissions |
Write / Mutation Tools
| Tool Name | Required Scope | Notes |
|---|---|---|
create_lead | leads:write | Supports idempotency key |
update_lead | leads:write | Status / assignment |
create_campaign | campaigns:write | Draft; supports idempotency key |
update_campaign | campaigns:write | Pause / resume / cancel |
create_order | orders:write | Supports idempotency key |
update_order | orders:write | Status + tracking URL |
upload_knowledge | knowledge:write | Text or Q&A (files/website via dashboard) |
update_agent | agents:write | Edit agent config |
Destructive & Billable Tools
| Tool Name | Required Scope | Why Guarded |
|---|---|---|
send_message | messages:send | Contacts a customer; may incur cost |
send_campaign | campaigns:send | Contacts many customers; may incur cost |
delete_lead | leads:write | Irreversible operation |
delete_campaign | campaigns:write | Irreversible operation |
Note on Safety Confirmation: Calling any tool in this category returns a preview and a short-lived token. The action will only execute once this token is sent back in a confirmation request.