# Getform MCP > Getform MCP connects your AI agent directly to your Getform accounts. Use it to programmatically submit data, whether it's a lead capture or feedback entry, and retrieve full lists of form submissions instantly. Stop leaving your chat window to check on new leads; just ask for them. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** form-backend, endpoint-management, data-collection, submission-tracking, api-forms ## Description Managing forms usually means logging into a separate dashboard, finding the right form ID, and manually checking entries. This MCP changes that by allowing you to treat your Getform endpoints like any other API service. You can use natural language commands to send structured data—like name, email, or specific feedback messages—directly to your backend forms. Need to see what came in last week? Ask the agent to list submissions for a form ID and get a clean summary right where you are working. It's designed for anyone who needs reliable data collection without leaving their primary workflow. Because this MCP is housed on Vinkius, you connect once from your preferred AI client and gain immediate access to these critical form management tools. ## Tools ### getform_list_submissions Retrieves a list of all submissions made to a specified Getform form ID. ### getform_submit_form Sends structured data, including names and emails, to submit new entries on a specific form. ## Prompt Examples **Prompt:** ``` Submit a new contact request to form ID 'abc123xyz' with the name 'Alice' and email 'alice@example.com'. ``` **Response:** ``` I've successfully submitted the data to form abc123xyz. The submission has been recorded. ``` **Prompt:** ``` List the latest submissions for my Getform form 'form-id-789'. ``` **Response:** ``` I found 3 recent submissions for form 'form-id-789'. Here are the details: 1. From Bob (bob@...), 2. From Charlie (charlie@...), 3. From Diana (diana@...). ``` **Prompt:** ``` Send this JSON data to Getform endpoint 'xyz-999': { "feedback": "Great service!", "rating": 5 }. ``` **Response:** ``` The feedback data has been sent to the Getform endpoint 'xyz-999' successfully. ``` ## Capabilities ### Submit structured form data You send specific pieces of information (like a name or email) directly into the designated Getform endpoint. ### List all form submissions The agent pulls a record list, showing details for every submission made to a specified form ID. ### Send custom JSON payloads You can structure and send complex data blocks that map to specific fields in your backend forms. ## Use Cases ### Handling post-event feedback A marketing manager runs an online webinar and needs immediate feedback. Instead of waiting for the manual email reports, they ask their agent to list submissions for the event form ID using `getform_list_submissions`. They get a count and a summary of all recent entries in seconds. ### Automating lead capture from scripts A developer writes a quick script that captures user details. Rather than building a complex webhook, they use the agent to submit the collected name and email using `getform_submit_form`, ensuring the data hits the correct backend immediately. ### Logging support inquiries A customer service representative receives an inquiry via chat. Instead of opening a ticket system, they ask their agent to submit the details into the official 'support request' form ID, logging it instantly for follow-up. ### Bulk data testing A developer needs to test how their form handles different types of submissions. They use the agent to send multiple structured JSON payloads with varying field values to confirm endpoint stability and validation rules. ## Benefits - Check for new leads instantly. You can ask the agent to list submissions, so you never have to manually navigate to your Getform dashboard just to count how many people signed up. - Programmatic data entry is simple. Instead of copy-pasting details from a spreadsheet into a form, you simply tell your agent to submit the information using `getform_submit_form`. - Maintain context. You get submission lists or success confirmations right in your chat interface, keeping your workflow centralized and efficient. - Handle complex data. The MCP supports sending structured JSON payloads, letting you send custom blocks of text or ratings that map directly to specific backend fields. - Test endpoints safely. Developers can use the agent to verify form submissions against a test form ID without needing specialized API keys or coding environment access. ## How It Works The bottom line is you tell your agent what data to send or which forms to check, and it handles all the API calls in the background. 1. First, you subscribe to this MCP on Vinkius and input your unique Getform API Key. 2. Next, you instruct your AI agent using natural language, telling it which form ID needs updating or checking. 3. Finally, the agent executes the request by calling the necessary tool, returning a clean list of submissions or confirmation that the data was sent. ## Frequently Asked Questions **How do I submit a form using the Getform MCP?** You use `getform_submit_form`. You just need to tell your agent the Form ID and provide the required data points, like the name and email address. The agent handles sending it correctly. **Can I list submissions for any Getform form?** Yes, you can use `getform_list_submissions`. You must specify the Form ID in your request so the agent knows exactly which data set to check and retrieve. **Does this MCP require an API Key?** Yep. The listing data shows it requires a Protected Mode (API Key) for secure access, especially when running `getform_list_submissions`. **Is the data format flexible with Getform MCP?** It's pretty robust. You can send structured JSON payloads that map to specific fields, which is great for complex feedback or rating systems. **What if I don't know my Form ID?** You'll need to find your unique Form ID within your Getform account settings first. The agent needs that ID to target the correct backend endpoint.