{
  "markdown": "# BankSync MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@banksync/mcp)](https://www.npmjs.com/package/@banksync/mcp)\n[![PyPI version](https://img.shields.io/pypi/v/banksync-mcp)](https://pypi.org/project/banksync-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![smithery badge](https://smithery.ai/badge/banksync/banksync-mcp)](https://smithery.ai/servers/banksync/banksync-mcp)\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPX-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=banksync&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40banksync%2Fmcp%22%5D%2C%22env%22%3A%7B%22BANKSYNC_API_KEY%22%3A%22your-key%22%7D%7D)\n\nTalk to your bank data. Connect AI agents to real bank accounts — transactions, balances, investments, and loans — across 15,000+ financial institutions.\n\nBankSync MCP is an open [Model Context Protocol](https://modelcontextprotocol.io) server with **28 tools** that gives Claude, ChatGPT, Cursor, VS Code, and other AI agents secure, read-write access to your financial data. Sync to Notion, Google Sheets, and Airtable — all through conversation.\n\n<!-- mcp-name: io.banksync/mcp -->\n\n<p>\n  <a href=\"https://banksync.io/product/mcp\">Website</a> ·\n  <a href=\"https://banksync.io/developers\">Docs</a> ·\n  <a href=\"https://banksync.io/developers/mcp-setup\">Setup Guides</a> ·\n  <a href=\"#quick-start\">Quick Start</a> ·\n  <a href=\"docs/TOOLS.md\">Tools Reference</a>\n</p>\n\n---\n\n## Quick Start\n\nGet your API key at [banksync.io/developers](https://banksync.io/developers). BankSync runs as a remote MCP server — no install required:\n\n```\nURL:       https://mcp.banksync.io\nTransport: Streamable HTTP\nHeader:    X-API-Key: your-key\n```\n\n## Setup\n\n<details>\n<summary><strong>Claude Desktop</strong></summary>\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"banksync\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.banksync.io\",\n      \"headers\": {\n        \"X-API-Key\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Claude Code</strong></summary>\n\n```bash\nclaude mcp add --transport http banksync https://mcp.banksync.io \\\n  --header \"X-API-Key: your-key\"\n```\n\n</details>\n\n<details>\n<summary><strong>Cursor</strong></summary>\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"banksync\": {\n      \"url\": \"https://mcp.banksync.io\",\n      \"headers\": {\n        \"X-API-Key\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>VS Code (Copilot)</strong></summary>\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"banksync\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.banksync.io\",\n      \"headers\": {\n        \"X-API-Key\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>Windsurf</strong></summary>\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"banksync\": {\n      \"serverUrl\": \"https://mcp.banksync.io\",\n      \"headers\": {\n        \"X-API-Key\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary><strong>npm package (stdio fallback)</strong></summary>\n\nFor clients that don't support remote HTTP servers, use the npm package as a local bridge:\n\n```bash\nnpx -y @banksync/mcp              # Node.js\npip install banksync-mcp && banksync-mcp  # Python\n```\n\nSet `BANKSYNC_API_KEY=your-key` as an environment variable. The package bridges stdio to `https://mcp.banksync.io` automatically.\n\nExample config (any stdio client):\n\n```json\n{\n  \"mcpServers\": {\n    \"banksync\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@banksync/mcp\"],\n      \"env\": {\n        \"BANKSYNC_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n> Setup guides for all clients: [banksync.io/developers/mcp-setup](https://banksync.io/developers/mcp-setup)\n\n## What You Can Do\n\nAsk your AI agent questions like:\n\n- *\"What were my biggest expenses last month?\"*\n- *\"How much do I have across all my accounts?\"*\n- *\"Show my investment portfolio performance\"*\n- *\"Sync my transactions to Notion every week\"*\n- *\"What's my outstanding loan balance?\"*\n\n## Tools\n\n28 tools across 7 categories. Full reference with parameters and examples: **[docs/TOOLS.md](docs/TOOLS.md)**\n\n| Category | Tools | What They Do |\n|----------|-------|-------------|\n| **Discovery** | `get_data_type_schema`, `list_feed_sources` | Discover available fields and feed source types |\n| **Workspace** | `list_workspaces`, `get_workspace`, `list_integrations`, `delete_integration` | Manage workspaces and connected destinations |\n| **Banks** | `list_banks`, `get_bank`, `create_bank_link`, `connect_bank`, `delete_bank` | Connect and manage bank connections |\n| **Accounts** | `list_accounts`, `get_account` | Fetch live account data from institutions |\n| **Financial Data** | `get_transactions`, `get_balance`, `get_holdings`, `get_trades`, `get_loan` | Query transactions, balances, investments, loans |\n| **Feeds** | `list_feeds`, `get_feed`, `create_feed`, `update_feed`, `validate_feed`, `delete_feed` | Build automated data pipelines |\n| **Jobs** | `list_jobs`, `get_job`, `trigger_sync`, `cancel_job` | Run and monitor sync jobs |\n\n## How It Works\n\n```\nAI Agent (Claude, ChatGPT, Cursor, ...)\n    ↓ Streamable HTTP\nmcp.banksync.io (Cloudflare Workers)\n    ↓ Bank APIs\nPlaid (US/UK/CA) · Basiq (AU/NZ)\n    ↓ Sync\nNotion · Google Sheets · Airtable\n```\n\nSee [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for details.\n\n## Typical Workflow\n\n```\n1. list_workspaces          → find your workspace\n2. list_banks               → see connected banks\n3. list_accounts            → discover accounts\n4. get_transactions         → fetch financial data\n5. list_integrations        → find your Notion/Sheets connection\n6. get_data_type_schema     → discover available field mappings\n7. create_feed              → set up an automated pipeline\n8. trigger_sync             → run it\n```\n\n## Data Sources\n\n| Provider | Coverage | Data Types |\n|----------|----------|------------|\n| **Plaid** | US, UK, Canada — 12,000+ institutions | Transactions, balances, investments, loans |\n| **Basiq** | Australia, New Zealand — 3,000+ institutions | Transactions, balances |\n| **Email extraction** | Global | AI-extracted structured data from forwarded emails |\n| **File upload** | Global | AI-extracted data from PDFs, images, documents |\n\n## Sync Destinations\n\n| Destination | Capabilities |\n|-------------|-------------|\n| **Notion** | Sync to Notion databases |\n| **Google Sheets** | Sync to spreadsheets (row or column direction) |\n| **Airtable** | Sync to Airtable tables |\n\n## Security\n\n- API key authentication — keys scoped per workspace\n- All data encrypted in transit (TLS)\n- Role-based permissions (owner/admin/editor/viewer)\n- BankSync never stores banking credentials — delegated to Plaid/Basiq\n- Stateless MCP transport — no session data persisted\n\nSee [SECURITY.md](SECURITY.md) for our security policy and vulnerability reporting.\n\n## Debugging\n\nUse the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) to test and debug the server:\n\n```bash\nBANKSYNC_API_KEY=your-key npx @modelcontextprotocol/inspector npx -y @banksync/mcp\n```\n\nOr connect the inspector directly to the remote server:\n\n```bash\nnpx @modelcontextprotocol/inspector --url https://mcp.banksync.io --header \"X-API-Key: your-key\"\n```\n\n## Documentation\n\n| Doc | Description |\n|-----|-------------|\n| **[docs/TOOLS.md](docs/TOOLS.md)** | Complete tools reference with parameters and examples |\n| **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)** | Architecture, transport, and deployment details |\n| **[docs/AGENTS.md](docs/AGENTS.md)** | Guide for AI agents: best practices, prompt patterns, workflows |\n| **[CLAUDE.md](CLAUDE.md)** | Context for AI coding assistants working on this repo |\n| **[SECURITY.md](SECURITY.md)** | Security policy and vulnerability reporting |\n| **[banksync.io/developers](https://banksync.io/developers)** | Full API documentation |\n| **[banksync.io/developers/mcp-setup](https://banksync.io/developers/mcp-setup)** | Per-client setup guides |\n\n## Privacy Policy\n\nBankSync's privacy policy is available at [banksync.io/privacy](https://banksync.io/privacy). BankSync never stores banking credentials — authentication is delegated to Plaid and Basiq. API keys are scoped per workspace and all data is encrypted in transit.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 8499,
  "sha": "11375bec6fd5bcd14751a6d33d27b60c072759c64df6708085370702dd7d6c01",
  "repo_slug": "banksynchq/banksync-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_banksync_mcp_73aa9415/readme"
}