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.

Related MCP server: jupiter-mcp

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