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: callput-agent-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@latest (To always fetch the newest bug fixes) 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@latest"],
      "env": {
        "RPC_URL": "https://api.mainnet-beta.solana.com",
        "WEB_UI_BASE_URL": "https://stableperp.tech"
      }
    }
  }
}

Note for Cursor / Windsurf: You can set these environment variables directly within the MCP settings UI when adding the server.

Updating / Troubleshooting

If your AI assistant is returning outdated or incorrect market data, it may be using a cached version of the MCP Server. To force an update to the newest version (e.g., >=1.0.3):

• Claude Desktop: Quit the application completely (Cmd+Q / Ctrl+Q) and reopen it. This forces npx to check for the @latest tag.

• Cursor/Windsurf: Restart the MCP Server from the settings panel, or manually run npx clear-npx-cache in your terminal before restarting.

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