Ikiform MCP server
Commit Nov 8, 2026Lets an AI client manage website forms, triage submissions, and debug webhooks through an automated backend.
Also known as preetsuthar17/ikiform-plugin, ikiform-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 8, 2026
- License
- MIT
What is Ikiform MCP?
Ikiform lets an AI client manage website forms, triage submissions, and debug webhooks through an automated backend.
Summary generated from the project's README
About Ikiform MCP server
Ikiform provides a backend for managing website forms, handling everything from spam blocking to webhook delivery. This MCP server allows AI agents to interact directly with your form infrastructure. Developers can use it to connect HTML or framework-based forms to the Ikiform service, manage form settings, and monitor incoming data. It is designed for use with Claude Code, Cursor, and VS Code through various installation methods.
To use the server, you must provide an API key via the IKIFORM_API_KEY environment variable or through specific client configurations. The server supports different permission levels through scopes like forms:read, submissions:write, and webhooks:write. These scopes control whether the agent can simply list forms, create new ones, read submissions, or perform administrative tasks like replaying failed webhook deliveries. This granular control ensures the agent only accesses the data necessary for the specific task at hand.
What you can do with it
- 1Connect forms to backendAn agent can integrate a new contact or waitlist form into your existing web project.
- 2Manage form submissionsYou can ask an AI to review recent entries and filter out spam content.
- 3Debug webhook failuresThe agent can investigate why a webhook delivery failed and attempt to replay the event.
- 4Configure form settingsAn AI client can modify form properties such as allowed domains or redirect URLs.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ikiform MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ikiform MCP in Claude Code
$ claude mcp add --transport http ikiform-plugin https://ikiform.com/mcpInstall Ikiform MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ikiform-plugin": {
"url": "https://ikiform.com/mcp"
}
}
}Install Ikiform MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ikiform-plugin": {
"type": "http",
"url": "https://ikiform.com/mcp"
}
}
}Install Ikiform MCP in VS Code CLI
$ code --add-mcp '{"name":"ikiform-plugin","type":"http","url":"https://ikiform.com/mcp"}'Install Ikiform MCP in Codex
$ codex mcp add ikiform-plugin --url https://ikiform.com/mcpInstall Ikiform MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ikiform-plugin] url = "https://ikiform.com/mcp"
Install Ikiform MCP in Gemini CLI
$ gemini mcp add -s user --transport http ikiform-plugin https://ikiform.com/mcpInstall Ikiform MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ikiform-plugin": {
"url": "https://ikiform.com/mcp",
"type": "http"
}
}
}Configuration
IKIFORM_API_KEY
| Name | Description | |
|---|---|---|
| IKIFORM_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepreetsuthar17/ikiform-plugin is public and reachablegithub.com/preetsuthar17/ikiform-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/preetsuthar17/ikiform-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- 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 GitHubIkiform for Claude Code and other agents
Ikiform is the backend for any form. Point an HTML form, a framework form or a server request at https://ikiform.com/f/<formId>. Ikiform validates the post, blocks spam, stores it and sends signed webhooks.
This repository has two things:
- An Agent Skill (
ikiform) that teaches a coding agent to connect a form to Ikiform, post from a server, verify Ikiform webhooks and triage submissions. It works in Claude Code and any agent that readsSKILL.mdskills. - A Claude Code plugin that bundles the skill with the Ikiform MCP server, so the agent can look up your forms, create them, read submissions and debug webhooks.
Install in Claude Code
In a Claude Code session:
/plugin marketplace add preetsuthar17/ikiform-plugin
/plugin install ikiform@ikiform
Or from your shell:
claude plugin marketplace add preetsuthar17/ikiform-plugin
claude plugin install ikiform@ikiform
Set your API key
The plugin's MCP server reads your key from the IKIFORM_API_KEY environment variable.
-
Create a secret key at https://ikiform.com/dashboard/api-keys.
-
Give it the scopes you want the agent to have:
Scope Lets the agent forms:readList forms and read a form's endpoint, fields and setup steps forms:writeCreate forms and change name, allowed domains or redirect URL submissions:readList and read submissions submissions:writeMark spam or not spam, and delete submissions webhooks:readList webhook endpoints and deliveries webhooks:writeSend test events and replay failed deliveries forms:readis enough to wire forms into your code. Add more only if you want the agent to do more. -
Export it in the shell you start Claude Code from, for example in
~/.zshrc:export IKIFORM_API_KEY=ik_sk_... -
Start Claude Code and run
/mcp. The server shows asplugin:ikiform:ikiform.
The key is a secret. Keep it in your shell profile or a secrets manager, never in a repository or in browser code.
The skill works without the key. Without it, the agent asks you for the form id from the dashboard instead of looking it up.
Use it
Ask in plain words, for example:
- "Connect the contact form in this project to Ikiform."
- "Add a waitlist form to the landing page and send it to Ikiform."
- "Verify Ikiform webhooks in our Express server."
- "Show me this week's spam on the Contact form."
- "Why is my Ikiform webhook failing?"
Or run the skill directly with /ikiform:ikiform.
The agent asks before it deletes a submission or replays webhook deliveries.
Use the skill in other agents
The skill is a plain Agent Skills folder: plugins/ikiform/skills/ikiform/. Copy it into your agent's skills directory.
With the skills CLI, for Claude Code, Cursor, Codex and other agents:
npx skills add preetsuthar17/ikiform-plugin
Claude Code without the plugin:
git clone https://github.com/preetsuthar17/ikiform-plugin ikiform-plugin
mkdir -p ~/.claude/skills
cp -R ikiform-plugin/plugins/ikiform/skills/ikiform ~/.claude/skills/ikiform
Use .claude/skills/ikiform inside a project instead to share it with your team. For other agents, copy the same folder into the directory that agent reads skills from. The skill uses only name, description and license in its frontmatter, so it stays portable.
Connect the MCP server without the plugin
Server: https://ikiform.com/mcp, Streamable HTTP, authenticated with Authorization: Bearer ik_sk_....
Claude Code
claude mcp add --transport http ikiform https://ikiform.com/mcp --header "Authorization: Bearer ik_sk_..."
Cursor
In ~/.cursor/mcp.json, or .cursor/mcp.json in a project:
{
"mcpServers": {
"ikiform": {
"url": "https://ikiform.com/mcp",
"headers": {
"Authorization": "Bearer ${env:IKIFORM_API_KEY}"
}
}
}
}
VS Code
In .vscode/mcp.json. VS Code asks for the key the first time and stores it securely:
{
"inputs": [
{
"type": "promptString",
"id": "ikiform-api-key",
"description": "Ikiform secret API key (ik_sk_...)",
"password": true
}
],
"servers": {
"ikiform": {
"type": "http",
"url": "https://ikiform.com/mcp",
"headers": {
"Authorization": "Bearer ${input:ikiform-api-key}"
}
}
}
}
Tools
The full list of tools and the scope each one needs is at https://ikiform.com/docs/mcp#tools.
The server also has a connect_form prompt that returns setup steps for a form.
Layout
.claude-plugin/marketplace.json the "ikiform" marketplace
plugins/ikiform/
.claude-plugin/plugin.json plugin manifest
.claude-plugin/icon.png listing icon
.mcp.json the Ikiform MCP server
skills/ikiform/SKILL.md the skill
skills/ikiform/references/*.md detail the skill loads when needed
server.json MCP Registry listing
glama.json Glama listing
.github/workflows/publish-mcp.yml publishes server.json to the MCP Registry
scripts/check.mjs offline checks
Check changes
With Claude Code installed:
claude plugin validate --strict .
claude plugin validate --strict ./plugins/ikiform
Without it, or in CI, run the offline checks. They need Node 20 or later and no packages:
node scripts/check.mjs
They check that every JSON file parses, that SKILL.md has a valid name and description under the Agent Skills limits, that its relative links resolve, and that the marketplace entry matches the plugin manifest.
To try a local copy before publishing:
claude plugin marketplace add ./
claude plugin install ikiform@ikiform
Docs
- Ikiform docs: https://ikiform.com/docs
- Everything as markdown for agents: https://ikiform.com/llms.txt
- Support: hello@ikiform.com
License
MIT. See LICENSE.
Ikiform MCP questions
How do I add Ikiform MCP to Claude Code?
Run claude mcp add --transport http ikiform-plugin https://ikiform.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Ikiform MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I set up the Ikiform MCP server in Claude Code?
You can install the Ikiform plugin using the command /plugin marketplace add preetsuthar17/ikiform-plugin followed by /plugin install ikiform@ikiform within a Claude Code session.
Does the agent require an API key to function?
The agent skill can work without a key, but it will require you to manually provide the form ID from the dashboard instead of looking it up automatically.