Provision, scaffold, publish, and query headless forms directly from a coding agent.
Also known as jacobfunch/usefillo, usefillo, @usefillo/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.11.2
- Last commit
- Oct 16, 2026
- License
- MIT
What is Fillo MCP?
Fillo is an MCP server. Provision, scaffold, publish, and query headless forms directly from a coding agent.
Summary generated from the project's README
About Fillo MCP server
Fillo provides headless form infrastructure designed for developers who want to embed forms directly into their own products using their own user interface. Instead of using iframes, this system allows you to render forms in React, Vue, Svelte, Astro, or vanilla JavaScript. The server enables coding agents to manage the entire lifecycle of a form, including provisioning, scaffolding, publishing, and querying data.
Users interact with the service through the @usefillo/mcp server or the @usefillo/cli tool. The infrastructure supports browser-direct file uploads to storage providers like Google Drive, Box, or S3-compatible buckets. Once forms are live, responses can be managed via a schema-aware grid or sent to external destinations like Notion, Zapier, Google Sheets, or via signed webhooks and email. This setup ensures that forms behave as native components of your application rather than external embeds.
What you can do with it
- 1Automate form creationAsk your coding agent to provision and scaffold a new headless form structure.
- 2Embed forms in custom UIsIntegrate a published form into a React or Vue application using the provided renderers.
- 3Direct file uploads to storageConfigure forms to send files directly to a user's own S3 bucket or Google Drive.
Written from the project's README. Every use case is checked against a quote from it.
How to install Fillo MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Fillo MCP in Claude Code
$ claude mcp add usefillo -- npx -y @usefillo/mcpInstall Fillo MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"usefillo": {
"command": "npx",
"args": [
"-y",
"@usefillo/mcp"
]
}
}
}Install Fillo MCP in VS Code
.vscode/mcp.json
{
"servers": {
"usefillo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@usefillo/mcp"
]
}
}
}Install Fillo MCP in VS Code CLI
$ code --add-mcp '{"name":"usefillo","type":"stdio","command":"npx","args":["-y","@usefillo/mcp"]}'Install Fillo MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"usefillo": {
"command": "npx",
"args": [
"-y",
"@usefillo/mcp"
]
}
}
}Install Fillo MCP in Codex
$ codex mcp add usefillo -- npx -y @usefillo/mcpInstall Fillo MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.usefillo] command = "npx" args = ["-y", "@usefillo/mcp"]
Install Fillo MCP in Gemini CLI
$ gemini mcp add -s user usefillo npx -- -y @usefillo/mcpInstall Fillo MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"usefillo": {
"command": "npx",
"args": [
"-y",
"@usefillo/mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablejacobfunch/usefillo is public and reachablegithub.com/jacobfunch/usefillo ↗Pass
- Package names this repository as its source@usefillo/mcp names jacobfunch/usefillo as sourcenpmjs.com/package/@usefillo/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-16github.com/jacobfunch/usefillo ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @usefillo/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubFillo SDKs
Fillo is headless form infrastructure. You build a form in the hosted editor or define it in code, then render it inside your own product with your UI — React, Vue, Svelte, Astro, or plain browser JavaScript — instead of dropping in an iframe. One shared schema drives the builder, the renderers, API validation, and the responses grid, so a form looks and behaves like part of your app.
Files go browser-direct into storage you own (Google Drive, Box, or an S3-compatible bucket), resumable where the provider supports it. Responses land in a schema-aware grid with search, file downloads, a detail drawer, and CSV export, and can be delivered by signed webhooks, Google Sheets, Notion, Zapier, or email.
This repository holds the public SDK packages and the coding-agent skill. The product itself lives at fillo.so.
Packages
| Package | npm | What it is |
|---|---|---|
@usefillo/core |
npm · packages/core |
Framework-agnostic form schema, validation, conditional-logic engine, prefill, formatting, JS client, and the browser-direct upload protocol. Zero framework dependencies. |
@usefillo/react |
npm · packages/react |
Headless React renderer, hooks, upload UI, and an optional default stylesheet you can override or replace. |
@usefillo/dom |
npm · packages/dom |
Framework-neutral DOM renderer, custom element, and a standalone browser bundle for Vue, Svelte, Astro, and vanilla apps. |
@usefillo/cli |
npm · packages/cli |
fillo — start a workspace, stage and publish forms, and install the Agent Skill from your terminal. |
@usefillo/mcp |
npm · packages/mcp |
MCP server — provision, scaffold, publish, and query forms from a coding agent. |
The canonical coding-agent skill (the same bundle the CLI installs) lives in
plugins/fillo/skills/build-with-fillo.
All packages are MIT licensed.
Quickstart
Install a renderer and drop a published form into your app. @usefillo/react
and @usefillo/dom both re-export the parts of @usefillo/core you need, so you
rarely install core directly.
// React / Next.js
import { FilloForm } from "@usefillo/react";
import "@usefillo/react/styles.css"; // optional default theme — or bring your own
<FilloForm formId="cust-feedback" onSubmitted={(responseId) => confetti()} />
// Vue, Svelte, Astro, or plain browser JavaScript
import { createClient, defineForm, renderForm } from "@usefillo/dom";
import "@usefillo/dom/styles.css";
const client = createClient({ key: "pk_live_…" });
const form = defineForm({
id: "cust-feedback",
pages: [{ id: "p1", blocks: [
{ id: "email", kind: "email", label: "Work email", required: true },
{ id: "message", kind: "long_text", label: "What should we know?" },
] }],
});
renderForm("#fillo-form", { form, client, onSubmitted: (id) => console.log(id) });
Building with a coding agent
Fillo ships a provider-neutral Agent Skill that teaches your agent to build, embed, style, sync, and verify a Fillo form. Install it into a project:
npx @usefillo/cli@latest skill install
In Claude Code or Codex, this repository is also a plugin marketplace. The plugin bundles the skill with the hosted Fillo MCP server:
/plugin marketplace add jacobfunch/usefillo
/plugin install fillo@fillo
Then point your agent at the setup flow. From a Build with AI handoff in the
product the CLI also prints a one-line npx @usefillo/cli agent bootstrap …
command that installs the skill and connects the live workspace in a single run.
See fillo.so/agents for the full agent path and
fillo.so/docs for the reference.
Links
- Website — fillo.so
- Docs — fillo.so/docs
- Agents — fillo.so/agents
- Examples — fillo.so/examples
- Changelog — fillo.so/changelog
About this repository
This repo is a read-only mirror of the public SDK packages. They are developed in a private monorepo and mirrored here on release, so the code you see is the same code published to npm. History here is disposable: the mirror is force-pushed by an automated job on every release, so don't fork from a specific commit expecting it to stay put — depend on the npm packages instead.
Issues and questions are welcome here — see CONTRIBUTING.md. Pull requests against package code can't be merged directly, since the source lives upstream; open an issue and we'll bring the fix through the private repo.
Note on the account name. This mirror currently lives at
github.com/jacobfunch/usefillowhile theusefilloGitHub organization is being claimed. Once it is, the repo will be transferred to the org; GitHub keeps the old path redirecting, so existing links and clones keep working.
Fillo MCP questions
How do I add Fillo MCP to Claude Code?
Run claude mcp add usefillo -- npx -y @usefillo/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Fillo MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What can I do with the Fillo MCP server?
The MCP server allows you to provision, scaffold, publish, and query forms using a coding agent.
Does Fillo use iframes for form rendering?
No, Fillo is headless infrastructure that allows you to render forms inside your own product with your own UI instead of using an iframe.