# Formspree MCP > Formspree MCP manages your form submissions and automated data collection instantly. Pull leads, check feedback, or send test entries using natural language commands through any AI client. You can filter thousands of records by date range, sort them, and pull specific details from forms without ever exporting a CSV file. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** form-management, lead-capture, submissions, automation, data-collection ## Description Stop juggling spreadsheets just to find out who signed up last week. This MCP connects your Formspree account directly to your agent, treating it like an instant data analyst for all your website forms. You talk to your AI client, and it manages the submissions for you. Need to know every lead collected since Q1? The MCP lets you query submissions using specific date filters and sort orders, pulling exactly what you need without leaving your chat window. Want to check if a form is working correctly? You can programmatically submit test data, verifying the flow instantly. It even keeps an eye on spam, so your results are always clean. It’s all about turning conversation into actionable data. Connecting this MCP via Vinkius means you get access to world-class form management tools right alongside your other services, letting your agent handle everything from campaign lead retrieval to customer feedback analysis in one place. ## Tools ### list_submissions Retrieves all form submissions associated with a specified unique form ID. ### submit_form Sends new, structured data to a designated web form for testing or manual entry. ## Prompt Examples **Prompt:** ``` List the last 5 submissions for form hashid 'mqkvpogq'. ``` **Response:** ``` I've retrieved the 5 most recent submissions for form 'mqkvpogq'. They include entries from 'Alice Smith' and 'Bob Jones' regarding 'Project Inquiry'. Would you like to see the full message for any of these? ``` **Prompt:** ``` Check for any new submissions for form 'xknpdyzd' since 2024-01-01. ``` **Response:** ``` Searching for submissions since January 1st... I found 3 new entries. One is a newsletter signup and two are contact requests. Shall I summarize the contact requests for you? ``` **Prompt:** ``` Submit a test entry to form 'mqkvpogq' with name 'Test User' and message 'Hello from MCP'. ``` **Response:** ``` Submitting data... The test entry was successfully sent to form 'mqkvpogq'. Formspree confirmed the submission was received. ``` ## Capabilities ### Pulling Specific Form Entries You can retrieve all submissions for a specific form ID so you can analyze leads or review user feedback. ### Filtering Submissions by Date Query results using date ranges (since) and custom sorting to isolate exactly the data you need, ignoring noise. ### Sending Test Data to Forms Programmatically submit test contacts or messages to verify that a form is receiving input correctly. ### Managing Spam Submissions Tell the agent whether or not to include flagged submissions in your data pull, keeping your records clean. ## Use Cases ### Quarterly Campaign Review The Marketing Manager needs to know every lead captured on the 'Pricing Request' form between January 1st and March 31st. They ask their agent to list submissions with a date filter, getting an immediate summary without opening any spreadsheets. ### Responding to Urgent Feedback A Support Lead needs to check for all form inquiries received in the last two hours regarding 'Billing Errors.' They ask their agent to list submissions filtered by date and sort them by time, allowing immediate triage of critical issues. ### Testing a New Opt-in Form A Developer finishes building a new newsletter sign-up form. Instead of waiting for QA, they use the submit_form tool to send several test entries immediately and confirm data flow works flawlessly. ### Cleaning Up Old Data The team wants to analyze all submissions from a specific high-volume form but needs to exclude spam. They ask their agent to list submissions, specifically telling it to filter out any flagged entries for clean data analysis. ## Benefits - You get instant lead retrieval. Instead of manually exporting a CSV to check for recent signups, you ask your agent and pull the data right in the chat. - Deep filtering capability means no more searching through noise. You can query submissions by specific date ranges or sort orders to find exactly what matters. - Fast form validation. Developers can use the submit_form tool to test new form fields and verify that data writes correctly without deploying code changes. - Dedicated spam control. The agent lets you decide if flagged entries count toward your report, ensuring every piece of data you see is clean and reliable. - Single source of truth. Marketing teams can review both old campaign leads (using list_submissions) and recent inquiries in one conversation thread. ## How It Works The bottom line is that you don't have to leave your chat window or open a separate dashboard to manage form data. 1. Subscribe to this MCP and enter your Formspree API Key within Vinkius. 2. Your AI client authenticates the connection, making all form data accessible through natural conversation. 3. You instruct your agent (e.g., 'What were the submissions for my contact page since last Tuesday?') and receive an instant, structured answer. ## Frequently Asked Questions **How do I use the Formspree MCP to check submissions?** To see submissions, tell your agent to list submissions for a specific hash ID. You can also ask it to filter those results by date using the 'since' parameter. **Does Formspree MCP handle spam entries?** Yes, you can explicitly include or exclude flagged submissions when querying data. This keeps your reports clean and focused on legitimate user input. **Can I test a form submission with the Formspree MCP?** You absolutely can. Use the agent to submit test entries, which verifies that your forms are working correctly before going live. **What kind of data does the Formspree MCP pull?** The tool pulls structured form data: names, messages, contact info, and custom fields defined by the original form owner. **Is there a limit to how many records I can list with Formspree MCP?** The MCP supports advanced filtering and pagination. You ask for what you need; the tool handles querying large sets of data efficiently.