Stableperp MCP Server

An official Model Context Protocol (MCP) server for Stableperp - allowing AI agents (like Claude, Cursor, Windsurf) to securely interact with Stableperp options markets on the Solana blockchain.

Features

This MCP server provides the following tools to AI Assistants:

• get_markets_liquidity: Fetches all available options markets from Stableperp and filters them by available liquidity. AI can instantly know which markets are active and ready to trade.
• get_wallet_portfolio: Fetches the open Long and Short options positions for any provided Solana wallet address.
• generate_trade_link: Safely prepares a transaction URL. Instead of having the AI sign a transaction directly (which is a security risk), the AI returns a secure deep-link to the Stableperp Web UI (https://stableperp.tech) where the user can review and sign the transaction using their browser wallet.

Installation

You can run this server directly via npx in any compatible MCP client without installing it locally!

Configuring in Cursor / Windsurf

1. Open Settings -> MCP.
2. Add a new MCP Server.
3. Name: Stableperp
4. Command: npx
5. Args: -y stableperp-mcp (Once published to npm) or point directly to the local dist file: node /path/to/stableperp-mcp/dist/index.js

Configuring in Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "stableperp": {
      "command": "npx",
      "args": ["-y", "stableperp-mcp"]
    }
  }
}

Local Development

1. Clone the repository and install dependencies:

   npm install

2. Create a .env file from the example:

   cp .env.example .env

3. Build the project:

   npm run build

4. Start the server locally for testing:

   npm start

Environment Variables

• RPC_URL: Your Solana RPC endpoint (default: https://api.mainnet-beta.solana.com)
• WEB_UI_BASE_URL: The domain of the Stableperp Web UI for trade links (default: https://stableperp.tech)

License

ISC