How do I get an Access Token for Formstack?

You can generate a Personal Access Token in your Formstack account settings under the API section.

Can I retrieve the raw HTML of a form for embedding?

Yes! Use the 'get_form_html' tool and provide the Form ID. The agent will return the raw HTML code ready for use.

Is there a limit to the number of submissions I can retrieve?

The retrieval depends on your Formstack plan limits. The 'list_submissions' tool supports pagination to help you navigate through large sets of records.

Can I manage form webhooks through the agent?

Yes, you can use the 'list_form_webhooks' and 'create_webhook' tools to monitor and automate your real-time data notifications.

Formstack MCP Server for Pydantic AI 12 tools — connect in under 2 minutes

Name: Formstack
Availability: InStock
Author: Vinkius

ai.pydantic.dev/mcp

Built by Vinkius GDPR 12 Tools SDK

Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Formstack through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

    agent = Agent(
        model="openai:gpt-4o",
        mcp_servers=[server],
        system_prompt=(
            "You are an assistant with access to Formstack "
            "(12 tools)."
        ),
    )

    result = await agent.run(
        "What tools are available in Formstack?"
    )
    print(result.data)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Formstack MCP Server

Connect your Formstack account to any AI agent to automate your professional form management and data collection workflows through the Model Context Protocol (MCP). Formstack is the workplace productivity platform used by thousands of organizations to build custom forms, automate manual processes, and securely collect data. This MCP server enables you to manage your form library, retrieve submissions, and oversee fields and webhooks directly through natural conversation.

Pydantic AI validates every Formstack tool response against typed schemas, catching data inconsistencies at build time. Connect 12 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.

Key Features

Form Lifecycle — List all forms in your account, fetch detailed configuration metadata, and create or update forms instantly.
Submission Oversight — Retrieve real-time form submissions, fetch specific data for individual records, and track growth via submission stats.
Field Management — Access and list all fields defined within your forms to understand the data structure and validation rules.
Webhook Automation — Monitor and manage webhooks to receive real-time notifications for every form completion.
Embed Support — Retrieve the raw HTML of any form for quick embedding into external sites or applications.
Data Hygiene — Permanently delete forms or manage active statuses directly through simple AI commands.

The Formstack MCP Server exposes 12 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Formstack to Pydantic AI via MCP

Follow these steps to integrate the Formstack MCP Server with Pydantic AI.

Install Pydantic AI

Run pip install pydantic-ai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.py and run: python agent.py

Explore tools

The agent discovers 12 tools from Formstack with type-safe schemas

Why Use Pydantic AI with the Formstack MCP Server

Pydantic AI provides unique advantages when paired with Formstack through the Model Context Protocol.

Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application

Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Formstack integration code

Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors

Dependency injection system cleanly separates your Formstack connection logic from agent behavior for testable, maintainable code

Formstack + Pydantic AI Use Cases

Practical scenarios where Pydantic AI combined with the Formstack MCP Server delivers measurable value.

Type-safe data pipelines: query Formstack with guaranteed response schemas, feeding validated data into downstream processing

API orchestration: chain multiple Formstack tool calls with Pydantic validation at each step to ensure data integrity end-to-end

Production monitoring: build validated alert agents that query Formstack and output structured, schema-compliant notifications

Testing and QA: use Pydantic AI's dependency injection to mock Formstack responses and write comprehensive agent tests

Formstack MCP Tools for Pydantic AI (12)

These 12 tools become available when you connect Formstack to Pydantic AI via MCP:

create_form

Create a new form

create_webhook

Add a webhook

delete_form

Remove a form

get_form_details

Get form metadata

get_form_html

Get form raw HTML

get_form_stats

Get form submissions count

get_submission_details

Get submission data

list_form_fields

List form fields

list_form_webhooks

List form webhooks

list_forms

List all forms

list_submissions

List form submissions

update_form

Update form settings

Example Prompts for Formstack in Pydantic AI

Ready-to-use prompts you can give your Pydantic AI agent to start working with Formstack immediately.

"List all forms in my Formstack account."

"Show me the 5 most recent submissions for form '1234567'."

"Get the embed HTML code for my 'Survey' form (ID: 9876543)."

Troubleshooting Formstack MCP Server with Pydantic AI

Common issues when connecting Formstack to Pydantic AI through the Vinkius, and how to resolve them.

MCPServerHTTP not found

Update: pip install --upgrade pydantic-ai

Formstack + Pydantic AI FAQ

Common questions about integrating Formstack MCP Server with Pydantic AI.

How does Pydantic AI discover MCP tools?

Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.

Does Pydantic AI validate MCP tool responses?

Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.

Can I switch LLM providers without changing MCP code?

Absolutely. Pydantic AI abstracts the model layer. your Formstack MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.