# Bamsai

> Bamsai is an open-source MCP server for finance and payments. Remote MCP server pricing Korean blue chips from Hyperliquid perps while Seoul is closed. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web, CLI
- **Website:** https://bamsai.kr/developers
- **Repository:** https://github.com/eddyparkgg/bamsaikr
- **MCP Registry name:** io.github.eddyParkGG/bamsai
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Samsung Electronics, SK hynix and Hyundai Motor keep trading overnight and on weekends as Hyperliquid perpetuals, and Bamsai converts those prices to won using the Upbit KRW/USDC rate. The MCP server lets an agent read that overseas price while the Korean market is shut, along with how often past Korean opens followed it at the same stage of the US session.

It also computes the gap between the two markets after fees, tax, FX, funding, slippage and order lag, which is the arbitrage opportunity. Tools are predict_open, get_arbitrage, get_convergence_history, get_news and preview_pair_order. The last returns a preview only and never sends an order. The service does not predict the opening price outright, leaving that judgement to the user.

The endpoint is bamsai.kr/api/mcp over Streamable HTTP with no key, or a local stdio mode through npm. A REST API with an OpenAPI spec allows 300 requests a minute per IP. The code is MIT licensed, and the site and most of the README are written in Korean.

## Features

- **Overnight KRW pricing:** Shows Korean blue-chip prices from Hyperliquid perps converted to won.
- **Open-direction history:** Reports how often past Korean opens followed the overnight move.
- **Cost-adjusted arbitrage:** Nets out fees, tax, FX, funding, slippage and order lag.
- **Order preview:** Previews a paired order but never sends it.
- **News and history:** Returns news and past convergence records.

## Good for

- Check the overnight price of Samsung Electronics in won before the open
- Estimate whether a price gap between markets survives costs
- Review how past opens converged to the overseas price
- Give a trading bot a preview of a paired order

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bamsai https://bamsai.kr/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bamsai.kr/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bamsai": {
      "url": "https://bamsai.kr/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bamsai": {
      "type": "http",
      "url": "https://bamsai.kr/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bamsai": {
      "serverUrl": "https://bamsai.kr/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bamsai": {
      "type": "http",
      "url": "https://bamsai.kr/api/mcp"
    }
  }
}
```

## Tools

- `predict_open`: Overnight overseas price and how often past Korean opens followed it
- `get_arbitrage`: Price gap between markets net of fees, tax, FX, funding, slippage and order lag
- `get_convergence_history`: Past records of the gap converging
- `get_news`: News for the covered stocks
- `preview_pair_order`: Preview of a paired order; never sends orders

## FAQ

### Does it place orders?

No. preview_pair_order returns a preview only and never sends orders.

### Do I need an API key?

No. Reads work without a key, up to 300 requests a minute per IP.

### Which stocks are covered?

The README names Samsung Electronics, SK hynix and Hyundai Motor.

### Is it open source?

Yes, under the MIT licence.

### Is Bamsai free?

Yes. Bamsai is open source, so you can use and self-host it for free.

### How do I add Bamsai to Claude Code?

Run this command in your terminal: claude mcp add --transport http bamsai https://bamsai.kr/api/mcp

### What are the best alternatives to Bamsai?

The closest alternatives to Bamsai are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/bamsai
