How to Use the Faker MCP in Windsurf

Q: Can Windsurf use Faker to generate custom database seeds?

Yes, Cascade calls getusers and getcreditcards to generate complete user profiles, then writes them directly to your seed files.

Q: How does Cascade handle localized addresses with Faker?

Cascade passes specific country codes to getaddresses to generate regional data, then uses that output to test your address validation forms.

Q: Can Cascade chain multiple data generation tools?

Yes, Cascade calls getbooks to get titles, then immediately passes those titles to other tools to build complex relational mock databases.

Feed Windsurf real-looking mock data to build and test entire database schemas without writing manual fixtures.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Faker MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chaining custom schemas with Cascade

`get_custom` lets you pass a JSON object mapping field names to specific types like emails or names so Cascade can generate exact datasets on the fly. Cascade takes this structure and immediately populates your local database files with valid data. Instead of you generating one-off files, your agent reads your schema, calls this tool, and writes the output directly to your test directory. You get tailored data shapes without opening a browser or writing custom scripts.

Populate UI prototypes in Windsurf

`get_products` and `get_images` supply authentic catalog items and image URLs from sources like Picsum to fill out your frontend components. Cascade chains these calls to populate your state managers and mock APIs in a single run. You tell Cascade to build a product grid, and it pulls real-looking titles, prices, and pokemon images to render realistic layouts. It runs the entire sequence autonomously, saving you from pasting placeholder text.

Localized testing with Cascade

`get_addresses` and `get_companies` provide localized geographic and corporate data, allowing you to test regional validation rules. Cascade detects your validation logic and selects the correct country codes to feed your forms. It uses this MCP Server to verify how your app handles international formats. The agent generates the data, runs the local server, and checks for parsing errors in one continuous loop.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "faker-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 Faker API. 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 Faker 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 Faker MCP in Windsurf

Open Settings, head to Cascade, and add the server under the mcpServers key, or edit your `~/.codeium/windsurf/mcp_config.json` file directly.

Yes, Cascade calls `get_users` and `get_credit_cards` to generate complete user profiles, then writes them directly to your seed files.

Cascade passes specific country codes to `get_addresses` to generate regional data, then uses that output to test your address validation forms.

Yes, Cascade calls `get_books` to get titles, then immediately passes those titles to other tools to build complex relational mock databases.

All generated user profiles and credit card details are ephemeral, processed in a secure V8 sandbox, and never stored or sent to external servers.

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

Mastra AI sdk-typescript

Start using the Faker MCP today

We host it, we monitor it, we maintain it. You just paste one token.

Get started