How to Use the Hexometer MCP in Windsurf

Q: Can I check multiple sites with Hexometer and Windsurf?

Yes. Start by asking Windsurf to listmonitoredsites. It will return all the properties you're tracking in Hexometer, and you can then tell it which one to audit.

Q: How is my Hexometer data privacy handled by Windsurf?

Your website audit data, like SEO reports from runseoaudit and error logs from checkpageerrors, is processed in a V8 Isolate sandbox. Vinkius ensures each session is ephemeral, so your data isn't stored after the job is done.

Connect Hexometer to Windsurf and let Cascade run your entire site audit automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hexometer MCP to Windsurf

Create your Vinkius account to connect Hexometer to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Hexometer with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Audits on Autopilot

Stop babysitting your agent. Give Windsurf a goal like "check the main site's health," and its Cascade feature takes over. It's smart enough to plan and execute a whole sequence on its own. Cascade might start with `list_monitored_sites` to find the right property, then run `get_site_health`, `check_speed_desktop`, and `get_security_status` back-to-back. You get the final report without having to ask for each step.

Dig into Performance Bottlenecks

Don't just get a score, get the data. Once Cascade flags a slow page, you can ask Windsurf to dig deeper. It can use `check_speed_mobile` to see how it performs on phones or `check_page_errors` to find heavy assets and JavaScript errors. This isn't about vague reports. You get a list of specific files and errors that are slowing things down. It's actionable data you can hand right to your dev team.

Keep Your SEO and Content Clean with this MCP Server

A site audit isn't complete without checking your content and links. Windsurf can run a full `run_seo_audit` to spot technical SEO issues or use `check_broken_links` to hunt down every last 404 error. This is perfect for pre-deployment checks or regular site maintenance. You can even have it check on your WordPress integrations by calling `list_wordpress_syncs` to make sure everything is connected properly.

Setup guide

Set up Hexometer MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Hexometer MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Hexometer payment history." If connected, Cascade will call the Hexometer tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hexometer-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Hexometer. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Hexometer now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Hexometer MCP in Windsurf

Cascade automatically chains tools together. When you ask it to audit a site, it can use this Hexometer connection to run `get_site_health`, then `check_speed_desktop`, then `run_seo_audit` all in one sequence without you needing to prompt each step.

Yes. Start by asking Windsurf to `list_monitored_sites`. It will return all the properties you're tracking in Hexometer, and you can then tell it which one to audit.

Let Windsurf's Cascade decide. Just give it the goal, like "Find any problems with the marketing site." It will pick the best starting tool, which is usually `get_site_health` for a quick overview before diving deeper with a full `run_seo_audit`.

It's already built. You don't have to write any code to handle auth, endpoints, or parsing responses. Just connect this MCP server in Windsurf and start giving it commands.

Your website audit data, like SEO reports from `run_seo_audit` and error logs from `check_page_errors`, is processed in a V8 Isolate sandbox. Vinkius ensures each session is ephemeral, so your data isn't stored after the job is done.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript