CrossFin

io.github.bubilife1202Published by GitHub account bubilife1202v1.18.0Updated Oct 24, 2026

AI agent access to Asian crypto markets. Korean exchange routing and x402 paid APIs.

VerifiedStreamable HTTPWeb executableFinance Business & Commerce

Server details

Identifier: io.github.bubilife1202/crossfin
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account bubilife1202 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.bubilife1202%2Fcrossfin.svg)](https://sourceweft.com/mcp/io.github.bubilife1202%2Fcrossfin?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Gives an AI assistant access to Asian crypto market data, comparing Korean and global exchange prices and paying for API calls via x402.

What you can do: Compare prices, fees and the Korea-global spread across Korean and global exchanges, and plan cross-exchange transfer routes. Search and browse a service catalog, with service details, categories and an agent guide. Call paid API endpoints with automatic x402 USDC payment. Create wallets in a local ledger, check balances, transfer funds, list transactions and set daily budgets.
When to use it: Use it when you need to compare Korean and global crypto exchange prices, estimate the Korea premium, or plan a cross-exchange transfer route, or when an agent workflow needs x402 micropayments to call paid API endpoints.
Requirements: Runs locally over stdio via npx, or connects to a remote endpoint. Paid tools need EVM_PRIVATE_KEY and a Base wallet funded with USDC; CROSSFIN_API_URL and CROSSFIN_LEDGER_PATH are optional. Network access required.

Before you install

Paid tools sign and settle USDC payments on-chain using EVM_PRIVATE_KEY, at roughly 0.01 to 0.20 USD per call, so guard the private key and watch spending. Local ledger tools create wallets, transfer funds and write transaction records. Queries are sent to the CrossFin remote API.

Installation

In SourceWeft

Open CrossFin in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.bubilife1202%2Fcrossfin/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "crossfin": {
      "type": "http",
      "url": "https://crossfin.dev/api/mcp"
    }
  }
}

README

CrossFin MCP Server

[npm version] [Node.js] [MCP] [x402]

Give your AI agent access to Asian crypto markets. 16 tools for real-time Korean exchange data, cross-exchange routing, and x402 paid API execution across 14 exchanges.

Quick Start

That's it. Your agent now has 16 tools. Most tools work with no wallet setup, and payment-capable tools require EVM_PRIVATE_KEY.

Open beta note: CrossFin API endpoints are currently free, but payment-capable MCP tools still require wallet config for x402 flow compatibility.

Client Configuration

Claude Desktop

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

json

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

Cursor

.cursor/mcp.json in your project root:

json

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

VS Code

.vscode/mcp.json in your project root (or user-level in settings):

json

{  "inputs": [    {      "type": "promptString",      "id": "evm-key",      "description": "Base wallet private key for x402 payments (optional)",      "password": true    }  ],  "servers": {    "crossfin": {      "type": "stdio",      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "${input:evm-key}"      }    }  }}

{  "inputs": [    {      "type": "promptString",      "id": "evm-key",      "description": "Base wallet private key for x402 payments (optional)",      "password": true    }  ],  "servers": {    "crossfin": {      "type": "stdio",      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "${input:evm-key}"      }    }  }}

Windsurf

~/.codeium/windsurf/mcp_config.json:

json

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

{  "mcpServers": {    "crossfin": {      "command": "npx",      "args": ["-y", "crossfin-mcp"],      "env": {        "EVM_PRIVATE_KEY": "0x..."      }    }  }}

npx (standalone)

No EVM key? Omit EVM_PRIVATE_KEY entirely. Free tools work without one.

All 16 Tools

Routing Engine

Tool	Price	Description
`find_optimal_route`	x402 flow	Optimal crypto transfer path across 14 exchanges with 13 bridge coins
`list_exchange_fees`	Free	Trading + withdrawal fee comparison for all exchanges
`compare_exchange_prices`	Free	Live Bithumb KRW vs Binance USD price comparison
`get_kimchi_premium`	Free	Korean vs. global route spread preview (top 3 pairs)

Paid API Gateway

Service Registry

Tool	Price	Description
`search_services`	Free	Search registered services by keyword
`list_services`	Free	Browse the service catalog with category filter
`get_service`	Free	Get details for a specific service
`list_categories`	Free	List all service categories with counts
`get_guide`	Free	Full CrossFin agent guide (services, pricing, x402 flow)
`get_analytics`	Free	Gateway usage stats (total calls, top services)

Local Ledger

Tool	Price	Description
`create_wallet`	Free	Create a wallet in the local CrossFin ledger
`get_balance`	Free	Check wallet balance (KRW)
`transfer`	Free	Transfer funds between wallets
`list_transactions`	Free	Transaction history (optionally filtered by wallet)
`set_budget`	Free	Set a daily spend limit (KRW)

Sample Prompts

Korean

빗썸에서 바이낸스로 500만원 USDC 만들려면 가장 싼 방법이 뭐야?

지금 한국-글로벌 스프레드 얼마야?

거래소별 XRP 가격 비교해줘

오늘 한국 시장 브리핑해줘

English

What's the cheapest way to move 5M KRW from Bithumb to Binance as USDC?

Show me the current Korea-global crypto spread.

Compare XRP prices across exchanges.

Give me this morning's Korean market brief.

Supported Exchanges

Korea: Bithumb, Upbit, Coinone, GoPax Regional Fiat: bitFlyer, WazirX, bitbank, Indodax, Bitkub Global: Binance, OKX, Bybit, KuCoin, Coinbase

Bridge Coins

BTC, ETH, XRP, SOL, DOGE, ADA, DOT, LINK, AVAX, TRX, KAIA, SUI, APT

Environment Variables

Variable	Required	Description
`EVM_PRIVATE_KEY`	For paid tools	Base wallet private key for x402 USDC payments
`CROSSFIN_API_URL`	No	API base URL (default: `https://crossfin.dev`)
`CROSSFIN_LEDGER_PATH`	No	Local ledger file path (default: `~/.crossfin/ledger.json`)

x402 Payments

Paid tools use the x402 protocol for automatic micropayments. When your agent calls a paid endpoint:

The API responds with 402 Payment Required and a price header
The MCP server signs a USDC payment on Base (L2) using your EVM_PRIVATE_KEY
The payment is submitted and the API returns the data along with a transaction receipt

Payments settle on-chain. Each response includes txHash and a Basescan link for verification. Prices range from $0.01 to $0.20 per call.

To get started, fund a Base wallet with USDC and set EVM_PRIVATE_KEY. No account registration or API keys required.

Agent Discovery

CrossFin exposes standard discovery endpoints so agent frameworks can auto-detect capabilities:

Endpoint	Description
`/.well-known/ai-plugin.json`	OpenAI plugin manifest
`/.well-known/agent.json`	A2A Agent Card (Google Agent-to-Agent protocol)
`/.well-known/x402.json`	x402 payment discovery (network, token, payTo)
`/.well-known/crossfin.json`	CrossFin metadata (MCP, API, registry links)
`/llms.txt`	LLM-friendly service description

Tools

SourceWeft has not read this server's tools yet.

Version history

v1.18.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

CrossFin

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

CrossFin MCP Server

Quick Start

Client Configuration

Claude Desktop

Cursor

VS Code

Windsurf

npx (standalone)

All 16 Tools

Routing Engine

Paid API Gateway

Service Registry

Local Ledger

Sample Prompts

Supported Exchanges

Bridge Coins

Environment Variables

x402 Payments

Agent Discovery

Links

Tools

Version history

Score