MCP servers

Swan provides MCP (Model Context Protocol) servers that give AI assistants direct access to Swan's GraphQL API schema and documentation. Use them to generate accurate GraphQL queries and get answers about Swan's API.

note

Swan's MCP servers only support the Streamable HTTP transport protocol.

GraphQL schema server

URL: https://mcp.swan.io/graphql/mcp

This server lets AI assistants explore Swan's GraphQL schema to help you write queries, mutations, and understand type relationships.

Setup

Cursor

Add to your Cursor MCP configuration file:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "swan-graphql": {
      "url": "https://mcp.swan.io/graphql/mcp"
    }
  }
}

After saving the configuration, enable the server in Cursor Settings > MCP.

Refer to Cursor's MCP documentation for more information.

Claude

Claude.ai and Claude Desktop UI

1. Go to Settings > Connectors.
2. Click Add custom connector.
3. Enter the URL: https://mcp.swan.io/graphql/mcp
4. Click Add.

The server is now available in your Claude conversations.

Refer to Getting started with custom connectors for more information.

---

Claude Desktop configuration file

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "swan-graphql": {
      "url": "https://mcp.swan.io/graphql/mcp"
    }
  }
}

Restart Claude Desktop after saving the configuration.

Refer to Claude Desktop's MCP guide for more information.

---

Claude Code

Run the following command:

claude mcp add --transport http swan-graphql https://mcp.swan.io/graphql/mcp

Refer to Claude Code's MCP documentation for more information.

ChatGPT

1. Open ChatGPT and go to Settings.
2. Select Connectors in the sidebar.
3. Click Add connector and choose Add MCP server.
4. Enter a name (for example, Swan GraphQL) and the URL: https://mcp.swan.io/graphql/mcp
5. Click Add.

The server is now available in your ChatGPT conversations.

Refer to OpenAI's MCP connectors documentation for more information.

Other clients

Use the following settings to configure any MCP-compatible client:

• URL: https://mcp.swan.io/graphql/mcp
• Transport: Streamable HTTP

Refer to your client's documentation and the Model Context Protocol specification for setup instructions.

Available tools

Tool	Description	Example prompts
search-graphql-schema	Searches the schema using keywords to find relevant types, fields, and operations.	• "Find all types related to payments" • "What fields are available for accounts?" • "Show me SEPA credit transfer mutations" • "Search for card-related types"
introspect-graphql-type	Gets detailed information about specific GraphQL types, including fields and related types.	• "What is the Account type?" • "Show me all fields on the Transaction type" • "How do I create a SEPA credit transfer?" • "Explain the AccountMembership type and its relationships"

Documentation server

URL: https://mcp.swan.io/docs/mcp

This server lets AI assistants search Swan's documentation to help you find guides, concepts, and integration information.

Setup

Cursor

Add to your Cursor MCP configuration file:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "swan-docs": {
      "url": "https://mcp.swan.io/docs/mcp"
    }
  }
}

After saving the configuration, enable the server in Cursor Settings > MCP.

Refer to Cursor's MCP documentation for more information.

Claude

Claude.ai and Claude Desktop UI

1. Go to Settings > Connectors.
2. Click Add custom connector.
3. Enter the URL: https://mcp.swan.io/docs/mcp
4. Click Add.

The server is now available in your Claude conversations.

Refer to Getting started with custom connectors for more information.

Claude Desktop configuration file

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "swan-docs": {
      "url": "https://mcp.swan.io/docs/mcp"
    }
  }
}

Restart Claude Desktop after saving the configuration.

Refer to Claude Desktop's MCP guide for more information.

Claude Code

Run the following command:

claude mcp add --transport http swan-docs https://mcp.swan.io/docs/mcp

Refer to Claude Code's MCP documentation for more information.

ChatGPT

1. Open ChatGPT and go to Settings.
2. Select Connectors in the sidebar.
3. Click Add connector and choose Add MCP server.
4. Enter a name (for example, Swan Docs) and the URL: https://mcp.swan.io/docs/mcp
5. Click Add.

The server is now available in your ChatGPT conversations.

Refer to OpenAI's MCP connectors documentation for more information.

Other clients

Use the following settings to configure any MCP-compatible client:

• URL: https://mcp.swan.io/docs/mcp
• Transport: Streamable HTTP

Refer to your client's documentation and the Model Context Protocol specification for setup instructions.

Available tools

Tool	Description	Example prompts
search-documentation	Searches Swan's documentation to find relevant guides and information.	• "How do I onboard a company account holder?" • "What are the card spending limits?" • "Explain SEPA Direct Debit mandates" • "Find information about account memberships"

Next steps

• Learn about Swan's GraphQL API
• Explore the API with API Explorer
• Test your integration in Sandbox