Available MCP Tools
FunnelStory exposes four tools through the MCP server.
| Tool | What it does |
|---|---|
query_semantic_db | Run SQL queries against your workspace data |
get_flows | List flows or retrieve a specific flow's configuration |
configure_flow | Create or update a flow |
run_flow | Execute a flow and return its output |
query_semantic_db
Runs a SQL query against FunnelStory's semantic database — a structured view of your workspace data including accounts, metrics, predictions, activities, meetings, notes, tasks, tickets, and needle movers.
Your AI assistant can read the schema first (available as the file://semantic/schema.sql resource) to understand what tables and columns are available before querying.
Input:
| Field | Type | Description |
|---|---|---|
query | string | SQL query to run |
get_flows
Returns flow metadata for the workspace. Pass a flow_id to get the full configuration of a specific flow — including its trigger, input schema, and graph. Omit it to get a summary list of all flows.
Input:
| Field | Type | Description |
|---|---|---|
flow_id | string | (Optional) ID of the flow to retrieve |
configure_flow
Creates a new flow or updates an existing one. Pass flow_id to update; omit it to create. Flows saved with draft: true won't trigger automatically — useful while you're still building.
Read the file://flow/guide.md resource for the complete flow authoring reference.
Input:
| Field | Type | Description |
|---|---|---|
flow_id | string | (Optional) Flow to update; omit to create |
name | string | Display name |
draft | boolean | If true, saves without publishing |
trigger_config | object | When and how the agent runs — see Triggers (manual, schedule, interval, activity, signal, needle_mover, conversation, query) |
input_schema | array | Input fields the flow accepts |
config | object | Flow graph with entrypoint and steps |
run_flow
Executes a flow by ID and waits for it to complete. If the flow sets a response variable, that value is returned to the caller.
Input:
| Field | Type | Description |
|---|---|---|
flow_id | string | ID of the flow to run |
input | object | (Optional) Input values, merged with flow defaults |
Next Steps
- Examples — example prompts using these tools
- Getting Started — connect your MCP client
- AI Agents — product concepts, triggers, and examples
- Vibe coding — using MCP to author agents end-to-end