How to Use the REST Countries MCP in Cursor

Q: Can I commit my REST Countries config to the repo?

Yes. You can place the config in .cursor/mcp.json to share it with your team. This ensures every developer uses the same toolset for consistency.

Inject real-world geography into your codebase using Cursor. Stop writing mock data and start coding with live API responses.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect REST Countries MCP to Cursor

Create your Vinkius account to connect REST Countries to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup REST Countries with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Real-time country data in Cursor Agent

Feed live country records into your code generation workflow. Using `get_country_by_name` ensures the AI writes code based on current, verified data. You avoid the common trap of using outdated stubs. The agent writes functions that actually match the API schema.

Filter regional data inside your IDE

Use `get_countries_by_region` to populate dropdowns or test cases within your editor. It is faster than manual entry and keeps your logic grounded in reality. Your Cursor environment handles the tool call, fetches the data, and lets you insert the raw results directly into your file.

Connect REST Countries to your project logic

Use `get_countries_by_currency` to validate international payment logic. You get the exact country list associated with a currency code without leaving the editor. It reduces the time spent looking up ISO standards. Your code gets the right list every time you run the tool.

Setup guide

Set up REST Countries MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the REST Countries MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent REST Countries transactions." If the MCP tools are loaded correctly, Cursor will call the REST Countries tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "rest-countries-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 REST Countries. 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.