MCP Server
Connect any MCP-compatible AI assistant to Surface and build forms, query your funnel, and manage content with natural language
Connect any MCP-compatible AI assistant (Claude, Cursor, Windsurf, and more) to your Surface environment. Ask it about your forms, responses, leads, analytics, workflows, and AI scores in plain English. It can also build a whole form for you: steps and components, conditional routing, styling, the marketing pane, and publishing.
The MCP server exposes 128 tools in 16 tool families. A new connection loads the forms and vault bundles (45 tools) by default, so your assistant is not flooded with definitions it does not need. See Tool Bundles.
What Can You Do?
Form Building
Create forms from a plain-English spec: steps, questions, identity fields, schedulers, conditional routing. Edit any existing form component by component.
Styling & Marketing
Restyle forms with typed design tokens, per-component styles, or whole-form themes. Write and edit the marketing (story) pane: headlines, testimonials, logos, FAQs.
Responses & Leads
Search and filter responses, track completion status, browse qualified leads, get counts broken down by source or funnel stage.
Analytics
Completion rates, dropoff analysis, daily trends, landing page performance, UTM breakdowns, conversion funnels.
AI Scoring
Top-scored leads, score distributions, form comparisons, full-text response search.
Workflows
List workflow runs, filter by status, inspect per-step execution details and errors.
AI Visibility
AEO/GEO answer-engine visibility: reports, tracked prompts, per-model scores, cited sources, scans.
Content & CMS
Content analytics and AI traffic sources, the blog review pipeline, and a full headless CMS: content types, entries, and assets.
SDK Form Authoring
Create self-hosted Forms SDK forms, hand your coding agent the exact HTML binding contract, and statically validate the markup before it ships.
Vault & HubSpot
Browse and edit the environment's Markdown knowledge Vault, and read connected HubSpot contacts, companies, deals, owners, and properties.
Prerequisites
You need a Surface API key to connect, or OAuth via Claude Connectors with no key at all. The credential decides which environment the MCP server can reach, and every tool call is scoped to it.
Create an API key
Go to Settings > API Keys in your Surface dashboard and click + Add API Key. Copy the key straight away, it is not shown again.
Connect your AI assistant
Follow the setup guide for your specific client (Claude Desktop, Cursor, Claude Code, etc.).
Pick your tools (optional)
The default connection loads the forms and vault bundles. Add ?tools= to the server URL to load a different bundle, family, or exact tool list.
Start asking
Ask your AI assistant about your Surface data, or ask it to build something, in plain English.
Example Prompts
- "Create a new demo booking form with name, email, company fields and a scheduler step"
- "Build a form in our brand colors that skips the demo step for companies under 10 people"
- "Create an SDK form for our signup flow and give me the binding map for the page"
- "Validate this rendered HTML against the signup form's record before I deploy it"
- "Update the headline and testimonial on the demo form's marketing pane"
- "Restyle my contact form to match our latest landing page, then publish it"
- "Set the SEO title and GA4 id on my contact form"
- "Show me the latest 10 responses for my Contact Us form"
- "What's the completion rate for our pricing survey?"
- "Which question has the highest dropoff in the onboarding form?"
- "Give me the top 5 leads by AI score"
- "Show me the conversion funnel for the last 7 days"
- "How many leads came from each source in Q1?"
- "Show me failed workflow runs from this week"
- "List my completed AEO/GEO visibility reports and give me the PDF links"
- "What pages are getting the most AI-driven traffic?"
- "Paste this markdown as a new blog draft and assign it to the pricing cluster"
- "Create a new blog post entry in the CMS and publish it"