Skip to content

MCP server

Connect Claude, Codex, Cursor, and other MCP-compatible AI agents to Quickly’s hosted Streamable HTTP MCP server. The server is included on every plan, including the free tiers.

Connection

Use a workspace API key to connect an MCP client to Quickly. The server uses the same permission model as the public API.

Server URL
https://mcp.askquickly.ai/api/mcp/v1
Authentication
Authorization: Bearer qk_...

Connect from Codex

Create a workspace API key in Quickly, store it as an environment variable, then register the Streamable HTTP MCP server.

export QUICKLY_API_KEY="qk_..."

# ~/.codex/config.toml
[mcp_servers.quickly]
url = "https://mcp.askquickly.ai/api/mcp/v1"
bearer_token_env_var = "QUICKLY_API_KEY"

Tools

The v1 MCP catalog supports reading knowledge, inspecting records, triggering playbooks, and auditing outcomes. Destructive actions require the right scope and still pass through Quickly’s workflow safety controls.

ToolDescription
knowledge_searchSearch workspace knowledge bases and return grounded results.
knowledge_base_listList available workspace knowledge bases.
playbook_listFind playbooks an agent can run.
playbook_triggerTrigger a governed playbook run with approval and audit controls.
playbook_run_getFetch a specific playbook run.
playbook_run_listList recent playbook runs.
entity_listSearch workspace entities and CRM-style records.
entity_getFetch a specific entity record.
entity_createCreate a workspace-scoped entity record.
entity_updateUpdate a workspace-scoped entity record.
task_listList recent Quickly task and audit records.
task_getFetch one task with execution details.
agent_listList scheduled playbook agents.

API key scopes

Assign only the scopes the connected agent needs. Available MCP key scopes are:

  • knowledge:read
  • knowledge:write
  • playbooks:read
  • playbooks:execute
  • logs:read
  • agents:read
  • messages:read
  • messages:write
  • web:read

Agent-readable discovery

AI agents can start with these public discovery files to find the API, MCP server, setup instructions, and safety model without crawling the full marketing site.