How to Use the JSONPlaceholder MCP in Windsurf

Prototype UIs in Windsurf with an agent that chains API calls for you, using live mock data from JSONPlaceholder.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JSONPlaceholder MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fetch Relational Data Autonomously

Start by telling Cascade to show you everything about a user. It will plan and execute a chain of calls, first using `get_user` to grab the profile, then `get_user_posts` and `get_user_albums` to pull in their content. You don't have to prompt for each step. Cascade sees the relationship between users, posts, and albums and figures out the sequence on its own. It's the fastest way to see how nested data will look in your UI.

Autonomous UI Mocking with this MCP Server

Give Cascade a goal like 'test the post creation flow.' It will use the `create_post` tool to make a new entry, then `patch_post` to edit the title, and finally `get_post` to confirm the changes. When you're done, just tell it to clean up. Cascade knows `delete_post` is the right tool for the job. You get to test the full lifecycle of a resource without writing a single line of API client code.

Instantly Populate Mock UIs

Need to build a photo gallery or a user directory? Just ask. Cascade can call `list_users` to get a full list of mock users for a sidebar, then run `list_albums` and `list_photos` to populate the main content area. Because Cascade handles the tool execution, you get mock data flowing into your components immediately. This lets you focus on layout and design instead of wrestling with API stubs.

Setup guide

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

mcp_config.json

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

Windsurf's agent, Cascade, can use the JSONPlaceholder tools to fetch live mock data for your UI components. For example, you can ask it to 'get all todos for user 5' and it will automatically call `get_user_todos` and feed the results into your code.

Yes, that's its main strength. Cascade autonomously chains tools. If you ask it to get a user's posts, it will call `get_user` then `get_user_posts` without you needing to specify both steps.

Use the built-in MCP Marketplace in Windsurf. Find JSONPlaceholder and click install. Your agent will discover all 21 tools automatically.

JSONPlaceholder is a public, shared testing service. While you can use `create_post`, the data is ephemeral and not guaranteed to persist. It's meant for temporary prototyping, not permanent storage.

This server only handles fake, publicly available data types like posts, comments, albums, and todos. Nothing you send is private. All connections run through Vinkius's ephemeral sandboxes, which are torn down after each session, so no request data is ever stored.

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