Build with agents

Ask your coding agent to add a Fillo form to your app. The project skill covers the schema, security rules, and checks.

Connect your agent

Fastest: paste the setup prompt into your coding agent. It installs the skill, connects your Fillo account, and builds the form in your app.

Or set it up by hand. Every agent gets the same skill; the MCP server adds publishing and responses, and signing in there creates your Fillo account.

Install the Fillo plugin: the skill and the MCP server together
/plugin marketplace add jacobfunch/usefillo
/plugin install fillo@fillo
No plugins? Run npx @usefillo/cli@latest skill install, then claude mcp add --transport http --scope user fillo https://fillo.so/api/mcp
Sign in to Fillo: run /mcp and choose fillo
/mcp

New to Fillo? Ask the human for their work email if it is not already in this task. Ask once, and never invent an address, infer or scrape it, or use a documentation placeholder. Then run this from the project the agent will edit, replacing <work-email> with that address. One command provisions a capped preview workspace and installs the skill below. The email receives a private workspace link. Finish the claim step below before handing the workspace over.

npx @usefillo/cli@latest agent bootstrap --email <work-email>

Already have a workspace? Connect it instead:

npx @usefillo/cli@latest login

Install the skill

Run this command from the application repository. It adds Fillo’s package, schema, security, and verification instructions to the project.

npx @usefillo/cli@latest skill install

Where the installer writes the skill

Host convention	Project path
Shared Agent Skills	`.agents/skills/build-with-fillo`
Claude Code	`.claude/skills/build-with-fillo`

Run the installer again to update the skill. For another project directory, use npx @usefillo/cli@latest skill install --dir <agent-skill-directory>. Add --global only when the target should resolve from your home directory.

Save the workspace before handoff

After building and verifying the form in a newly provisioned workspace, run:

npx @usefillo/cli@latest claim

Ask the human to open the newest workspace link in the inbox they supplied. They must use that same email to save the workspace, and approve this terminal only if its code matches the CLI. Wait for the CLI’s connected confirmation before reporting account setup complete.

If they cannot finish now, hand over the form’s actual publication state, the remaining inbox step, and the preview limits. An unclaimed preview is capped and expires. Do not open their inbox, guess another address, or claim on their behalf.

If setup fails

Provisioning reports that the email already has a workspace: run npx @usefillo/cli@latest login and continue with the existing workspace instead of provisioning another.
The CLI cannot reach Fillo: it targets FILLO_API or --api when either is set, otherwise https://fillo.so. Clear a stale override or start that deployment, then retry.
Provisioning is rate-limited, so avoid rapid retries.
For anything else, stop and show the human the exact error.

More for agents

Machine index: /llms.txt · full reference: /llms-full.txt
Docs as Markdown: /docs.md · API spec: /openapi.json
Example search: /api/v1/agent-examples/search?q=<query>

This page for agents: /agents.md · index at /llms.txt

Updated 5 September 2026