Developers
Build workflows from your coding agent
The Worfilo MCP server lets Claude Code, Cursor, Antigravity and VS Code plan AI workflows, build and test them, publish them, and wire them into your codebase. You describe the automation, the agent does the rest, and you approve each step that matters.
npx @worfilo/mcp installWhat your agent can do
Ask for an automation in plain words, for example “when a support email arrives, triage it and open a Linear issue”. The agent then does the whole job in your editor:
- Discover. Reads the node types and the apps, credentials, APIs and MCP servers the account has connected.
- Plan. Drafts a graph from a plain description, and shows you the steps before anything is saved.
- Build. Creates the workflow as a draft and fixes whatever validation finds.
- Test. Runs the draft with realistic input and reads failing nodes back to repair them.
- Publish. Publishes a version once you agree, so the API runs it.
- Integrate. Creates an API key scoped to that workflow, puts it in your env file, and writes the call into your code.
Each workflow is also a normal Worfilo workflow. Open it on the canvas to watch runs, change prompts, or hand it to a teammate.
Install
Run the installer in your project. It finds Claude Code, Cursor, Antigravity, VS Code and Windsurf, adds the Worfilo server to each, and adds the /worfilo-workflows guide. Existing servers are kept, and no secrets are written, so the files are safe to commit.
The command at the top of this page runs it with defaults. These options narrow it down:
npx @worfilo/mcp install --client claude-code,cursor # choose editors
npx @worfilo/mcp install --scope user # every project, not just this repo
npx @worfilo/mcp install --dry-run # show the changes, write nothing
npx @worfilo/mcp uninstall # remove them againIn Claude Code you can install Worfilo as a plugin instead. It bundles the server and the guide, and updates with the plugin:
/plugin marketplace add Worfilo/mcp
/plugin install worfilo@worfiloThe installer, the bridge and the guide are open source at Worfilo/mcp.
Set up an editor by hand
Prefer to edit the config yourself? The server is https://api.worfilo.com/mcp, over Streamable HTTP. Cursor reads .cursor/mcp.json, VS Code .vscode/mcp.json, Antigravity ~/.gemini/antigravity/mcp_config.json and Windsurf ~/.codeium/windsurf/mcp_config.json.
# every project
claude mcp add --transport http --scope user worfilo https://api.worfilo.com/mcp
# or this repo only, shared through .mcp.json
claude mcp add --transport http --scope project worfilo https://api.worfilo.com/mcpAntigravity uses the local bridge, which signs in on first use whatever remote sign-in the editor supports. Any editor can use it: pass --bridge to the installer.
Sign in and permissions
The first time the agent calls Worfilo, your browser opens. Sign in, check which editor is asking, and choose what it may do. Everything runs over OAuth 2.1 with PKCE, so the agent never sees your password.
| Permission | What it allows |
|---|---|
workflows:read | See workflows, node types, connections and credential names. Always on. |
workflows:write | Plan, create and edit draft workflows. |
workflows:publish | Publish versions and choose the active one. |
runs:write | Run workflows and read their results. |
api_keys:write | Create API keys limited to chosen workflows. |
Access tokens last an hour and refresh themselves. To see and disconnect every agent, go to API keys, under Connected agents. Disconnecting takes effect at once.
The bridge keeps its tokens on your machine, readable only by you, and manages them with three commands:
npx @worfilo/mcp login # sign in ahead of time
npx @worfilo/mcp status # see what this machine may do
npx @worfilo/mcp logout # revoke the tokens and forget themThe /worfilo-workflows guide
The installer adds a guide that teaches the agent the platform. It covers the graph format, the node types, templates, branching, and the steps from plan to integration, so the workflows it builds pass validation the first time.
- Claude Code: a skill,
/worfilo-workflows, which also loads by itself when you ask for an automation. - Cursor: the
/worfilo-workflowscommand, plus a rule the agent pulls in when it is relevant. - Antigravity: the
/worfilo-workflowsworkflow, plus a rule. - VS Code: the
/worfilo-workflowsprompt in agent mode.
Every MCP client also gets the guide as the design_workflow prompt, even without the installer. Print it with npx @worfilo/mcp skill.
Tools
The agent only sees the tools its permissions allow. Publishing, activating and creating keys are marked as consequential, so editors ask you first.
| Tool | Permission | Returns |
|---|---|---|
list_node_types, get_node_type | read | Every node type, then one type's ports and config schema |
list_integrations | read | Connected apps and their actions, credentials by name, custom APIs, MCP servers |
list_workflows, get_workflow | read | Workflows, their draft graph and published versions |
plan_workflow | write | A drafted graph and readable steps, not saved |
create_workflow, update_workflow | write | Save a draft and get validation issues back |
validate_workflow | read | The same checks publishing runs |
publish_workflow, activate_version | publish | Ship a version, or roll back to an earlier one |
run_workflow, get_run | runs | Run the draft or the published version and read the output |
create_api_key | api_keys | A key that can run only the workflows named |
get_integration_snippet | read | TypeScript, JavaScript, Python or curl code for the public API |
Calling the workflow from your code
A published workflow is an HTTP endpoint. The agent creates a key that can run only that workflow, and writes it to your env file as WORFILO_API_KEY. It then adds a call to POST /v1/workflows/{id}/runs that suits your stack and handles both a finished run and one still in progress. The Workflow API guide covers the request and response in full, and Worfilo/examples has complete clients in TypeScript, Python and curl.
Keep reading
- Workflow API: run workflows from your own codeCall a published workflow over HTTP with an API key and its workflow ID, send it input and get its output back, and test it first in the chat playground.
- Generate AI agent workflows from a descriptionDescribe a workflow in plain language and Claude drafts a validated Worfilo graph that uses your connected apps, APIs and MCP servers. Preview it, refine it, then create it.
- Building workflows on the canvasHow Worfilo workflows are structured: triggers, nodes, ports, data edges and tool edges, branching and merging, and how the executor decides what runs.
- MCP servers: a marketplace of tools for your workflowsConnect a Model Context Protocol server from the marketplace or by URL, and call its tools from a workflow node or hand them to an agent.
Build it on the canvas
Create a free account, describe the workflow or wire it yourself, and run it in the browser.