# SnipForm MCP > SnipForm connects your AI agents directly to a robust form backend, giving them control over static site submissions. Use this server to list all entries, filter spam, track conversion metrics, and manage forms programmatically via 15 dedicated tools. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** form-backend, spam-protection, submission-export, conversion-tracking, webhook-integration ## Description Yo, this MCP Server gives your AI client full control over a static site's form backend. You can treat submissions like any other data source you want—no more digging through clunky web dashboards. This thing houses 15 tools that let your agent manage everything from tracking spam to grabbing conversion stats, all without ever touching the front end code. ### Handling Form Submissions and Spam The `list_submissions` tool lets your agent pull every single form entry across all forms, letting you filter by date range or status. Need entries for one specific form? Use `list_submissions_by_key` to grab only the data tied to a known key. If you need the full payload for just one piece of work, run `get_submission`. And look, if something gets flagged as trash, the `list_spam` tool pulls all those automatically blocked records so you can review 'em. You can also permanently wipe out bad data using `delete_submission`, making sure that specific entry vanishes. ### Managing Forms and Keys Controlling access is key here. To set up a new form, your agent runs `create_key` to generate the necessary unique identifier for a fresh instance. If you need to check the details of an existing key without seeing every single one, use `get_key`. You can also modify how a form works with `update_key`, changing its settings or configuration on the fly. Need to shut down a form? The `delete_key` tool deactivates and completely nukes that key from the system. To see everything active, you run `list_keys`, which gives you a complete rundown of every managed form key. ### Tracking Performance Data To know if a form is actually working, your agent hits `get_form_analytics`. This tool fetches concrete metrics like total views and conversion rates for a specific form key. You can also get the whole picture—the general account information—by calling `get_account`, which is useful when you're auditing things or just need to verify who owns the setup. For clean data reporting, run `export_submissions` to package up submissions into formats like CSV or JSON. ### System Control and Audit Logs Your agent can check the system health using `check_snipform_status`, confirming that your SnipForm account connection is solid. To see where external services are hooked up, run `list_integrations`; this tool lists all webhooks or integrations—like Slack or Zapier hooks—attached to the account so you know exactly what’s connected. If you need a full manifest of every configured webhook and integration endpoint, that's what `list_integrations` handles. You can also get an overall list of how everything is integrated into your account by using `list_integrations`. This setup lets your AI client manage the entire data lifecycle: pull submissions, track performance numbers, secure access with keys, and export all that clean garbage for whatever process you're running. ## Tools ### check_snipform_status Verifies the connection status of your SnipForm account. ### create_key Generates a unique key to create and activate a new form instance. ### delete_key Deactivates and deletes an existing form key. ### delete_submission Permanently removes specific form submission data. ### export_submissions Exports a set of submissions into a usable format like CSV or JSON. ### get_account Retrieves general account information for auditing purposes. ### get_form_analytics Fetches conversion rates, view counts, and submission volume metrics for a specific form key. ### get_key Retrieves the details of an existing form key without listing all keys. ### get_submission Fetches the full data payload for a single, specific submission entry. ### list_integrations Lists all currently configured webhooks and integrations (e.g., Slack, Zapier) attached to your account. ### list_keys Returns a complete list of every active form key managed by the account. ### list_spam Retrieves submissions that were automatically flagged and blocked as spam. ### list_submissions_by_key Retrieves a list of submissions specifically tied to one known form key. ### list_submissions Lists all form entries across all forms, allowing filtering by date range or status. ### update_key Modifies settings or configurations for an existing form key. ## Prompt Examples **Prompt:** ``` Show the latest form submissions from our primary contact form. ``` **Response:** ``` I've retrieved the latest 5 submissions for your 'Contact Us' form. The most recent is from 'Jane Doe' regarding an enterprise inquiry. Would you like me to display the full message content? ``` **Prompt:** ``` List all submissions flagged as spam over the last 24 hours. ``` **Response:** ``` Checking the spam queue... I found 12 submissions blocked by the behavioral filter today. Most appear to be automated bot traffic. Do you want me to list the specific emails or IP addresses involved? ``` **Prompt:** ``` What is the conversion rate and submission volume for our newsletter signup form? ``` **Response:** ``` Fetching your form analytics... This month, your 'Newsletter Signup' form has received 450 views and 112 submissions, resulting in a conversion rate of 24.8%. All webhook integrations are currently delivering successfully. ``` ## Capabilities ### Retrieve and Filter Form Submissions List all form entries, filter submissions by key, retrieve individual entry details, and isolate spam-flagged records. ### Manage Forms and Keys Create, read, update, or delete the unique keys associated with specific forms to control access. ### Track Performance Data Fetch comprehensive analytics on a form's performance, including conversion rates and total views. ### Export Data & Audit Logs Package submission data into exportable formats or get overall account information for auditing purposes. ### Control Integrations List and manage webhook endpoints, ensuring your external services connect correctly. ## Use Cases ### Investigating a Lead Generation Dip The marketing team notices a sudden drop in signups. They ask their agent to check the funnel. The agent runs `get_form_analytics` for the newsletter form, sees the views are fine but submissions dropped. Next, it calls `list_spam` and discovers that a new bot script started hitting the site, triggering the spam filter and blocking leads before they even hit the database. ### Building a Custom Data Validator A developer needs to validate form data in a custom tool. Instead of using raw API calls, they ask their agent to run `get_submission` for recent entries and then pass that structured JSON payload through the validation step, ensuring type safety before processing. ### Auditing Form Access After Deployment The security team just updated a form. Before they trust it, they ask their agent to run `list_keys` and compare the output against the expected list. They can then use `get_key` on the new key to verify settings before going live. ### Pulling Data for Quarterly Reports The analyst needs a clean dataset of all leads from Q2. Instead of running reports in SnipForm's dashboard, they prompt their agent to run `list_submissions` over the last three months and then use `export_submissions`, getting a single CSV file ready for finance. ## Benefits - **Audit submissions easily.** Instead of sifting through a massive dashboard, you can use `list_submissions` or `list_spam` to pull exactly the entries you need—be it suspicious bot traffic or high-value leads. - **Track performance metrics instantly.** Don't guess about your conversion rate. Call `get_form_analytics` and get a clean breakdown of views vs. submissions for any form, right in your agent's output. - **Keep data secure by managing keys.** You can generate or delete forms using `create_key`/`delete_key`, giving you granular control over which part of your site is accepting input at any given time. - **Export data without manual steps.** When a campaign runs, you don't want to copy/paste hundreds of rows. Use `export_submissions` to get all the raw data ready for a spreadsheet or database import. - **Maintain integration health.** Check that your webhooks are connected and working by listing them with `list_integrations`. This saves time debugging failed third-party connections. ## How It Works The bottom line is that you tell your agent what to do (e.g., 'Find all spam from yesterday'), and it handles the API calls using these tools. 1. First, subscribe to the SnipForm MCP Server on Vinkius. 2. Next, provide your specific SnipForm API Key (you grab this from your developer dashboard). 3. Your AI client can then execute any of the 15 tools—for example, calling `list_submissions` or `get_form_analytics`—to manage data dynamically. ## Frequently Asked Questions **How do I check if SnipForm MCP Server is connected correctly?** Run the `check_snipform_status` tool. This verifies your API key works and confirms that your agent has full connectivity to the form backend. **What is the best way to find spam submissions using list_spam?** Use `list_spam`. This tool retrieves all entries blocked by SnipForm's filters. You can then ask your agent to filter that data further, for example, listing only IP addresses involved. **Can I get the conversion rate using get_form_analytics?** Yes, `get_form_analytics` provides this metric. You just need to specify the form key and time range. It returns a structured object showing views, submissions, and the calculated conversion percentage. **How do I list all my forms using list_keys?** The `list_keys` tool pulls every active form key associated with your account into a simple list. This is useful for auditing or figuring out which form needs an update. **What is the difference between get_submission and list_submissions?** `get_submission` gets one specific piece of data using its unique ID. `list_submissions` gives you a paginated overview, allowing you to see many entries at once. **How do I safely remove an old form using delete_key?** The tool instantly deletes the specified key and all associated submissions. This is a permanent action, so verify which form ID you're deleting before running it. **What information does the get_account tool provide?** It returns your core developer account metadata, including billing status and user limits. You run this to confirm your connection permissions without needing to query any actual form data. **If I only want submissions from one form, should I use list_submissions_by_key?** Yes, that is the most efficient method for targeted retrieval. It filters all submissions based on a specific key ID, giving you exactly the data set you need. **How can my AI review recent submissions for a specific contact form?** Simply use the `list_submissions` tool and provide the form key. Your agent will instantly retrieve all recent entries, including field data and metadata, so you can review inquiries without logging into the SnipForm dashboard. **Can I automatically check for messages that were blocked by the spam filter?** Yes. By running the `check_spam_queue` action, your agent can review all submissions flagged by the behavioral scoring system. You can inspect these entries safely to ensure no legitimate messages were falsely identified as spam. **Is it possible to track the performance and conversion rate of our forms?** Absolutely. Ask the agent to use the `get_form_analytics` tool. It will compile your submission volume, conversion rates, and integration delivery status over time, giving you a clear view of your lead generation metrics.