# Obsyn OTC

> Obsyn OTC is an open-source MCP server for crypto and web3. MCP server for private OTC block trades on Robinhood Chain with sealed bids. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://obsyn.trade/developers
- **Repository:** https://github.com/obsyndev/obsyn/tree/HEAD/packages/obsyn-mcp
- **MCP Registry name:** trade.obsyn/mcp
- **Categories:** crypto and web3
- **Listing updated:** 2026-11-18

## About

The README describes this server as a way to hand an MCP-capable agent a private trading desk for large token blocks. An agent can post a bid or a sell listing, read sealed answers, accept one, and settle both sides in a single transaction through a contract with no admin role.

Offers are encrypted and decrypted locally on the machine running the server, so the Obsyn backend only handles ciphertext and the wallet key stays in that process. Signatures on each answer are checked, and unverified answers are refused unless the operator explicitly allows them.

The server is aimed at developers and operators who want an agent to take part in OTC negotiation on Robinhood Chain. An optional autopilot mode can answer matching postings by rule, starting in dry-run mode, with per-deal and total caps.

## Features

- **Sealed bids and listings:** Post a bid or a sell listing and collect encrypted answers from counterparties.
- **Local decryption:** Offers are decrypted on the machine running the server, so the Obsyn server only sees ciphertext.
- **One-transaction settlement:** Both sides of an accepted deal settle together through an adminless contract.
- **Signature verification:** Answers are checked against the signing wallet, and unverified ones are refused by default.
- **Rule-based autopilot:** Answers matching configured rules automatically, dry-run by default, with spending caps.
- **Price lookup:** Fetches spot prices from a Uniswap v3 pool or a Pons curve.

## Good for

- Post a private buy bid for a large token block without showing it on a public order book
- Collect sealed sell offers for a block and accept the best one
- Run a rule-based agent that answers matching bids within set size and price limits
- Check deal status, deposits and refund timing for an open OTC trade

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env OBSYN_PRIVATE_KEY='<OBSYN_PRIVATE_KEY>' -- npx -y https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb"
      ],
      "env": {
        "OBSYN_PRIVATE_KEY": "<OBSYN_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb"
      ],
      "env": {
        "OBSYN_PRIVATE_KEY": "<OBSYN_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb"
      ],
      "env": {
        "OBSYN_PRIVATE_KEY": "<OBSYN_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb"
      ],
      "env": {
        "OBSYN_PRIVATE_KEY": "<OBSYN_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb"
      ],
      "env": {
        "OBSYN_PRIVATE_KEY": "<OBSYN_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `otc_info`: Chain, contract, fees, relayer, which wallet signs
- `otc_list_bids`: Open bids and sell listings
- `otc_create_bid`: Place a bid with token, size, currency and reply window
- `otc_create_listing`: List a block for sale and collect sealed bids
- `otc_get_offers`: Decrypt the answers to your bid or listing
- `otc_accept_offer`: Accept one answer to fix a deal
- `otc_send_offer`: Send a sealed, signed answer to a bid or listing
- `otc_deal_status`: Check acceptance, deposits and time left
- `otc_deposit`: Deposit your side of a deal
- `otc_refund`: Refund after the deadline
- `otc_price`: Spot price from a Uniswap v3 pool or a Pons curve
- `otc_autopilot_preview`: Dry-run autopilot rules against the live desk

## FAQ

### Does the server need a private key?

No. The README says the OBSYN_PRIVATE_KEY variable is optional. Without it, deposits and refunds are returned as unsigned transactions to send manually.

### Where does the wallet key go?

The README says the wallet key never leaves the local process, and offers are decrypted on the machine running the server.

### How is it installed?

The README gives an npx command for the GitHub release tarball, and an MCPB bundle for clients that support one-click installs. It requires Node 20 or newer.

### What is the license?

The README says the project is MIT licensed.

### Is Obsyn OTC free?

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

### How do I add Obsyn OTC to Claude Code?

Run this command in your terminal: claude mcp add mcp --env OBSYN_PRIVATE_KEY='<OBSYN_PRIVATE_KEY>' -- npx -y https://github.com/ObsynDev/obsyn/releases/download/mcp-v0.2.0/obsyn-mcp-0.2.0.mcpb

### What are the best alternatives to Obsyn OTC?

The closest alternatives to Obsyn OTC are Z1N, Glitter Agent Gate (x402), GONDI, Kote Charts — Bitcoin on-chain analytics and Janorium.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Z1N](https://ai-powered.com/mcp/z1n): Z1N is an open-source MCP server for crypto and web3.
- [Glitter Agent Gate (x402)](https://ai-powered.com/mcp/glitter-agent-gate-x402): Glitter Agent Gate (x402) is a paid MCP server for web search and scraping.
- [GONDI](https://ai-powered.com/mcp/gondi): GONDI is a free MCP server for crypto and web3.
- [Kote Charts — Bitcoin on-chain analytics](https://ai-powered.com/mcp/kote-charts-bitcoin-on-chain-analytics): Kote Charts — Bitcoin on-chain analytics is a free MCP server for finance and payments.
- [Janorium](https://ai-powered.com/mcp/janorium): Janorium is a free MCP server for finance and payments.
- [PriorSeal](https://ai-powered.com/mcp/priorseal-2): PriorSeal is an MCP server for security.
- [Mihenk AI](https://ai-powered.com/mcp/mihenk-ai): Mihenk AI is a freemium MCP server for marketing and seo.
- [NearVerse](https://ai-powered.com/mcp/nearverse): NearVerse is an open-source MCP server for games and play.

---
Source: https://ai-powered.com/mcp/obsyn-otc
