BANKSapi Documentation via MCP

The BANKSapi Documentation MCP Server connects AI coding assistants directly to the BANKSapi documentation. It enables AI agents like Claude, Cursor, or GitHub Copilot to search our docs, fetch specific pages, and access OpenAPI specifications—all without leaving your IDE.

Why Use This?

When integrating BANKSapi into your application, AI coding assistants can help you write code faster. But they need access to accurate, up-to-date documentation to do so effectively.

Without the MCP server, your AI assistant might:

• Hallucinate API endpoints that don't exist
• Use outdated authentication patterns
• Miss important concepts like REG/Protect or SCA handling

With the MCP server, your AI assistant can:

• Search the BANKSapi documentation semantically
• Fetch the exact Markdown content of any docs page
• Access the full OpenAPI specifications for code generation
• Understand BANKSapi-specific concepts (Users, Bank Accesses, HATEOAS)

Example Prompts

Once connected, try these prompts with your AI assistant:

Getting started:

"I want to integrate BANKSapi into my Node.js app. Show me how to authenticate and create a user."

Understanding concepts:

"Explain the difference between REG/Protect and regulated client flows in BANKSapi."

Code generation:

"Generate TypeScript types from the BANKSapi OpenAPI spec for the Customer API endpoints."

Specific implementation:

"How do I handle SCA/TAN renewal when a bank access consent expires?"

Available Tools

The MCP server exposes three tools:

Tool	Description	When to use
search-banksapi-docs	Semantic search across all documentation	Broad questions like "How do I authenticate?"
get-banksapi-docs-page	Fetch raw Markdown for a specific page	When you need specific page content or code samples
get-banksapi-openapi-spec	Get OpenAPI 3.0 specifications	For code generation, available: banks-connect, ai-connect, pay-connect

Additionally, get-banksapi-overview returns the llms.txt index file with all available documentation paths.

Installation

Claude Code

Add the MCP server to Claude Code via CLI:

claude mcp add \
  --transport http \
  banksapi-docs \
  https://banksapi.io/docs-mcp \
  --scope user

Manual configuration

Add the following to your settings file:

• User scope: ~/.claude/settings.json
• Project scope: your-repo/.claude/settings.json

{
  "mcpServers": {
    "banksapi-docs": {
      "type": "http",
      "url": "https://banksapi.io/docs-mcp"
    }
  }
}

Once added, start Claude Code (claude) and type /mcp to verify the connection.

Cursor

Add the following to your Cursor MCP configuration (.cursor/mcp.json):

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

VS Code with Copilot

1. Open Command Palette (⌘+Shift+P / Ctrl+Shift+P)
2. Select "MCP: Add Server..."
3. Choose HTTP and enter https://banksapi.io/docs-mcp

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "banksapi-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://banksapi.io/docs-mcp"]
    }
  }
}

Other MCP Clients

The server supports streamableHttp transport. Connect to https://banksapi.io/docs-mcp using HTTP transport.

Technical Details

• Endpoint: https://banksapi.io/docs-mcp
• Transport: streamableHttp
• Authentication: None required for docs access