How to Use the Franchimp MCP in Windsurf

Q: How do I add the Franchimp MCP Server to my Windsurf environment?

Open your Windsurf settings and add the server to your mcpconfig.json file under the mcpServers block. Cascade will instantly discover the 12 franchise tools.

Q: How does Franchimp handle credit usage inside the Windsurf interface?

Cascade can run listavailablecredits before initiating large batch queries. This prevents your Windsurf sessions from hitting unexpected API limits when pulling disclosure documents.

Q: Can Cascade download actual FDD files?

Cascade uses listfdddocuments to retrieve the list of available disclosure files via the MCP standard. From there, you can prompt Cascade to organize the document metadata within your workspace.

Feed Franchimp franchise data straight to Cascade in Windsurf to map out investment opportunities and verify operators without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Franchimp MCP to Windsurf

Create your Vinkius account to connect Franchimp 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 Franchimp with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run multi-step franchise lookups in Windsurf Cascade

The `search_franchisors` tool lets you hunt down brands matching your criteria, and Cascade handles the entire sequence of lookups from there. You tell Cascade to find high-growth brands, and it automatically triggers additional calls to `get_franchise_details` to pull the exact metadata you need. Instead of jumping between browser tabs, you let this MCP Server feed live franchise registries directly into your Windsurf editor. Cascade reads the returned JSON, spots the high-value targets, and organizes them into a local markdown file for your team.

Map franchisee networks autonomously

The `list_multi_unit_operators` tool identifies top-tier franchise owners who run multiple locations across different territories. Cascade takes this operator list and chains it with `get_franchisee_details` to compile complete profiles for your sales pipeline. You do not have to manually run separate queries in Windsurf for each franchise owner. Windsurf handles the entire loop in one go using this MCP integration, checking your remaining document balance with `list_available_credits` before pulling deeper contact info.

Pull financial stats directly into your project files

The `get_investment_stats` tool exposes the actual startup costs and financial requirements for any major brand. Cascade uses this data to update your local projection models, matching franchise opportunities against your client's liquid capital. When you need to verify the legal fine print, Windsurf calls `get_fdd_metadata` to grab registration dates and filing details. Cascade writes these metrics straight into your active code or configuration files without human intervention.

Setup guide

Set up Franchimp 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 Franchimp 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 Franchimp payment history." If connected, Cascade will call the Franchimp tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "franchimp-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 Franchimp. 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 Franchimp 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 Franchimp MCP in Windsurf

Open your Windsurf settings and add the server to your `mcp_config.json` file under the `mcpServers` block. Cascade will instantly discover the 12 franchise tools.

Yes, Cascade can combine the Franchimp tools to run multi-step searches. It can start with `list_franchisees` and automatically run `find_franchisee_by_email` to verify contact details.

Cascade can run `list_available_credits` before initiating large batch queries. This prevents your Windsurf sessions from hitting unexpected API limits when pulling disclosure documents.

Cascade uses `list_fdd_documents` to retrieve the list of available disclosure files via the MCP standard. From there, you can prompt Cascade to organize the document metadata within your workspace.

Yes, it is. Your franchisee contact info and FDD metadata stay secure because Vinkius runs the server in an isolated V8 sandbox. Your Windsurf client connects via a single secure token, and no data is stored on the host.

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