MCP Server
Connect any MCP-compatible AI assistant to Surface and build forms, query your funnel, and manage content with natural language
The Surface MCP server lets you connect any MCP-compatible AI assistant (Claude, Cursor, Windsurf, and more) to your Surface environment. Ask questions in plain English and get instant answers about your forms, responses, leads, analytics, workflows, and AI scores. Go further and have your assistant build entire forms: create steps and components, set up conditional routing, style everything, write the marketing pane, and publish, all through conversation.
The MCP server exposes 110 tools organized into 14 tool families. A new connection loads the forms bundle (39 tools) by default so your assistant isn't flooded with definitions it doesn't need; everything else is one config change away. 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.
Prerequisites
You need a Surface API key to connect (or use OAuth via Claude Connectors with no key at all). The credential determines which environment the MCP server can access; every tool call is automatically scoped to that environment.
Go to Settings > API Keys in your Surface dashboard and click + Add API Key. Copy the key immediately, it won't be shown again.
Follow the setup guide for your specific client (Claude Desktop, Cursor, Claude Code, etc.).
The default connection loads the forms bundle. Add ?tools= to the server URL to load a different bundle, family, or exact tool list.
Once connected, just ask your AI assistant about your Surface data, or ask it to build something, in plain English.
Example Prompts
Here are some things you can ask once connected:
- "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"
- "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"