Connect to the ISO 20022 MCP Server

Server: https://iso20022-mcp-v1.beneficialstrategies.com/mcp

Recommended platform: Claude Code. The Claude Code CLI and VS Code extension offer the best experience with this server — one command to connect, automatic credential storage, and full MCP support today. Claude Desktop (Chat tab) works but requires manual configuration steps.

Anonymous access is available without signing in — enough to browse message names and business areas. Sign in with Google to unlock your tier's full feature set.

Claude Desktop — Chat tab Coming Soon

Configures the Chat tab in Claude Desktop. The Cowork and Code tabs are separate environments and are not yet supported (see below).

Step 1 — Install mcp-remote

npm install -g mcp-remote

Step 2 — Get your API key

Visit https://iso20022-mcp-v1.beneficialstrategies.com/auth/api-key — sign in with Google and you'll see your API key plus the exact config to paste.

Step 3 — Edit the config file

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
      "iso20022": {
        "command": "mcp-remote",
        "args": [
          "https://iso20022-mcp-v1.beneficialstrategies.com/mcp",
          "--header",
          "Authorization: ApiKey YOUR_API_KEY"
        ]
      }
    }
  }

Replace YOUR_API_KEY with the key from step 2. Restart Claude Desktop after saving.

Claude Desktop — Cowork tab Coming Soon

Configuring the Chat tab does not give the Cowork tab access to this server. Cowork is a separate execution environment that does not currently support external MCP servers. We are monitoring Anthropic's roadmap for when this becomes available.

Claude Desktop — Code tab Coming Soon

The Code tab inside Claude Desktop runs its own isolated Claude Code session and does not inherit MCP servers from the Chat tab configuration. Use the Claude Code CLI instead — it has full MCP support today (see below).

Claude Code (CLI or VS Code extension) ✓ Supported

Add via the plugin marketplace:

claude plugin marketplace add Beneficial-Strategies/iso20022-mcp
  claude plugin install iso20022-mcp

Or add it manually to .claude/settings.json in your project (or ~/.claude/settings.json globally):

{
    "mcpServers": {
      "iso20022": {
        "type": "http",
        "url": "https://iso20022-mcp-v1.beneficialstrategies.com/mcp"
      }
    }
  }

When you first connect, a browser window opens for Google sign-in. After that, credentials are stored automatically.

Cursor Coming Soon

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project root:

{
    "mcpServers": {
      "iso20022": {
        "type": "http",
        "url": "https://iso20022-mcp-v1.beneficialstrategies.com/mcp"
      }
    }
  }

Reload the window (Cmd+Shift+P → Reload Window) to activate.

VS Code with GitHub Copilot Coming Soon

Add to .vscode/mcp.json in your workspace, or to your user settings.json:

{
    "mcp": {
      "servers": {
        "iso20022": {
          "type": "http",
          "url": "https://iso20022-mcp-v1.beneficialstrategies.com/mcp"
        }
      }
    }
  }

Other MCP-compatible clients

Any client supporting the Model Context Protocol can connect directly:

Setting	Value
Transport	Streamable HTTP (MCP 2025-03-26)
Server URL	`https://iso20022-mcp-v1.beneficialstrategies.com/mcp`

If your client only supports stdio, install mcp-remote and follow the Claude Desktop Chat tab pattern above.

Verify the connection

Ask your AI assistant: "What ISO 20022 business areas are available?"

A connected assistant queries the live spec and returns a structured list. An unconnected one guesses from training data.