RealWorldMCP
Setup · checked November 2, 2026

Connect Real World MCP to your AI client

Real World MCP is one remote MCP server at https://www.realworldmcp.com/api/mcp. It uses Streamable HTTP and needs no key or sign-in. Add it once and your agent gets search_tools, get_tool and call_tool and 22 live tools. Steps for each client are below, checked against each vendor's own docs.

Claude (web and desktop)

  1. Click Add Real World MCP to Claude . Claude opens Add custom connector with the name and URL filled in. If you are signed out, sign in first.
  2. Or add it by hand: go to Customize → Connectors, click + Add, then Add custom connector. Name it Real World MCP and paste the URL below. Click Continue.
  3. Under Authentication, pick No sign in. Click Add.
  4. In a chat, click +, open Connectors, and turn Real World MCP on.
https://www.realworldmcp.com/api/mcp

Free plans can add one custom connector. On Team and Enterprise plans an Owner adds it first under Organization settings → Connectors → Add → Custom → Web (or with the admin install link ); members then click Connect under Customize → Connectors. Claude reaches the server from Anthropic's cloud, so it must be public. Ours is.

Source, checked November 2, 2026: Anthropic help center · Claude install links

ChatGPT

  1. In ChatGPT on the web, go to Plugins , click the + button, then Add custom MCP server.
  2. Enter the name Real World MCP and an optional description.
  3. Under Connection, paste the server URL below.
  4. Under authentication, choose No authentication.
  5. Read the risk warning and select I understand and want to continue.
  6. Select Create as a plugin, then install the plugin before you use it in a chat.
https://www.realworldmcp.com/api/mcp

Custom MCP servers are set up on ChatGPT on the web, and workspace policies apply. OpenAI's help center lists full support on Business, Enterprise and Edu, and read-only use on Pro; check your own Plugins page for your plan. ChatGPT asks you to confirm a tool call unless the tool is marked read-only. Real World MCP has no published ChatGPT app.

Source, checked November 2, 2026: OpenAI: Add custom MCP server · OpenAI help center

Claude Code

  1. Run this once in your terminal.
  2. Inside Claude Code, type /mcp to check that the server is connected.
claude mcp add --transport http realworldmcp https://www.realworldmcp.com/api/mcp

This uses local scope: only you, in the current project. Add --scope user to use it in every project.

Source, checked November 2, 2026: Claude Code docs

Codex

  1. Run this once in your terminal:
codex mcp add realworldmcp --url https://www.realworldmcp.com/api/mcp

Or add this table to ~/.codex/config.toml yourself:

[mcp_servers.realworldmcp]
url = "https://www.realworldmcp.com/api/mcp"

The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share this config file.

Source, checked November 2, 2026: OpenAI Codex MCP docs · codex mcp add source

Gemini (app and CLI)

Gemini app

  1. On your computer, go to gemini.google.com.
  2. Click Settings, then Connected Apps. If you don't see it, click Personal Intelligence first.
  3. Under Custom apps, paste the URL below into Add a custom app link to get started (or click Add a custom app).
  4. Click Next and follow the on-screen steps.
https://www.realworldmcp.com/api/mcp

Google limits custom apps to people 18 or over in the US, signed in with a personal Google Account, with Keep Activity on. You add them on the web; they then work in the mobile app too.

Gemini CLI

Run this once, or add the server to ~/.gemini/settings.json:

gemini mcp add --transport http --scope user realworldmcp https://www.realworldmcp.com/api/mcp
{
  "mcpServers": {
    "realworldmcp": {
      "httpUrl": "https://www.realworldmcp.com/api/mcp"
    }
  }
}

Source, checked November 2, 2026: Gemini Apps Help · Gemini CLI MCP docs

Cursor

  1. With Cursor installed, click Add Real World MCP to Cursor. Cursor asks you to confirm the server.
  2. Or open ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project), or create it, and add the server below.
  3. Reload MCP servers or restart Cursor.
{
  "mcpServers": {
    "realworldmcp": {
      "url": "https://www.realworldmcp.com/api/mcp"
    }
  }
}

Source, checked November 2, 2026: Cursor MCP docs · Cursor install links

VS Code and GitHub Copilot

  1. Run this once in a macOS or Linux terminal. It adds the server to your VS Code user profile.
code --add-mcp '{"name":"realworldmcp","type":"http","url":"https://www.realworldmcp.com/api/mcp"}'

Or, for one workspace, add this to .vscode/mcp.json. You can also run MCP: Add Server from the Command Palette and pick HTTP.

{
  "servers": {
    "realworldmcp": {
      "type": "http",
      "url": "https://www.realworldmcp.com/api/mcp"
    }
  }
}

Source, checked November 2, 2026: VS Code MCP configuration

Windsurf (Devin Desktop)

  1. In Cascade, open the MCP menu and choose Open MCP config file. It opens mcp_config.json (on macOS and Linux, ~/.config/devin/mcp_config.json; on Windows, %AppData%/devin/mcp_config.json).
  2. Add the server below. Remote servers use serverUrl (or url).
  3. Save, then press the refresh button in the MCP panel.
{
  "mcpServers": {
    "realworldmcp": {
      "serverUrl": "https://www.realworldmcp.com/api/mcp"
    }
  }
}

Windsurf is now Devin Desktop; its docs moved to docs.devin.ai.

Source, checked November 2, 2026: Windsurf Cascade MCP docs · Devin Desktop MCP docs

Any other MCP client

Point any client that speaks Streamable HTTP MCP at the URL. The server needs no auth or key.

https://www.realworldmcp.com/api/mcp
{
  "mcpServers": {
    "realworldmcp": {
      "url": "https://www.realworldmcp.com/api/mcp"
    }
  }
}

Scripts can skip MCP: send POST https://www.realworldmcp.com/api/call/<tool_id> with the tool's input as a JSON body.

Source, checked November 2, 2026: MCP transports spec

Not listed

  • Meta Muse. The Muse app's connectors come from Meta's reviewed catalog, or Muse builds a custom one from a service's API when you ask. Meta documents no way to paste an MCP server URL into the app, so we don't give steps for it. Source

Questions people ask

How do I add Real World MCP to Claude?

Open https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Real%20World%20MCP&connectorUrl=https%3A%2F%2Fwww.realworldmcp.com%2Fapi%2Fmcp or go to Customize, Connectors, + Add, Add custom connector. Name it Real World MCP, paste https://www.realworldmcp.com/api/mcp, pick No sign in and click Add. Free plans can add one custom connector.

Can I add Real World MCP to ChatGPT?

Yes, as a custom MCP server on ChatGPT on the web. Open Plugins, click +, choose Add custom MCP server, paste https://www.realworldmcp.com/api/mcp under Connection, choose No authentication, accept the warning and select Create as a plugin. Plan and workspace limits apply.

How do I add Real World MCP to Claude Code?

Run claude mcp add --transport http realworldmcp https://www.realworldmcp.com/api/mcp, then type /mcp in Claude Code to see the tools.

How do I add Real World MCP to Codex?

Run codex mcp add realworldmcp --url https://www.realworldmcp.com/api/mcp, or add [mcp_servers.realworldmcp] with url = "https://www.realworldmcp.com/api/mcp" to ~/.codex/config.toml.

Does Gemini support Real World MCP?

The Gemini app can add a custom app by MCP URL under Settings, Connected Apps, for US users 18+ on a personal Google Account. Gemini CLI: run gemini mcp add --transport http --scope user realworldmcp https://www.realworldmcp.com/api/mcp.

How do I add Real World MCP to Cursor?

Use the install link on this page, or add "realworldmcp": {"url": "https://www.realworldmcp.com/api/mcp"} under mcpServers in ~/.cursor/mcp.json.

How do I add Real World MCP to VS Code and GitHub Copilot?

Run code --add-mcp '{"name":"realworldmcp","type":"http","url":"https://www.realworldmcp.com/api/mcp"}', or add "realworldmcp": {"type": "http", "url": "https://www.realworldmcp.com/api/mcp"} under servers in .vscode/mcp.json.

How do I add Real World MCP to Windsurf?

In Cascade's MCP menu choose Open MCP config file and add "realworldmcp": {"serverUrl": "https://www.realworldmcp.com/api/mcp"} under mcpServers, then refresh.

What URL do other MCP clients use?

https://www.realworldmcp.com/api/mcp. It is a remote Streamable HTTP MCP server with no auth.

ChatGPT, Claude, Codex, Cursor, GitHub Copilot, Gemini and Windsurf are trademarks of their respective owners. Real World MCP is not affiliated with them, and compatibility does not imply endorsement or partnership.