Learn
Obsidian Academy

MCP Server

Model Context Protocol server exposing every read + signed-write as a typed tool. Use with Claude Desktop, Claude Code, Anthropic SDK, or any MCP client.

Endpoints

Remote (SSE): https://mcp.obsidian.trading/mcp. Local (stdio): obsidian-mcp binary or docker compose run --rm mcp.

Tools

Every protocol surface exposed as a typed MCP tool with zod input schemas. Enumerate live tools with mcp.listTools.

  • get_market_overview, get_option, get_option_greeks — market reads
  • get_my_positions, options_by_writer, options_by_holder — portfolio reads
  • list_marketplace_offers, list_my_listings — marketplace reads
  • lending_markets, lending_market_detail, lending_positions, lending_health_factor — Magma reads
  • get_signing_domain, write_call_signed, write_put_signed — signed writes

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian": {
      "url": "https://mcp.obsidian.trading/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}