mcp -unusualwhales

This MCP server provides a wrapper around the Unusual Whales REST API, exposing a set of MCP endpoints that forward requests to the Unusual Whales service. By running the server, you can query market data, options data, and other resources exposed by Unusual Whales through the MCP protocol without direct API calls from your client. The server is designed to translate MCP requests into the corresponding Unusual Whales REST API calls and return the results in MCP-compatible responses. Ensure you have a valid Unusual Whales API key and set it in the environment to authorize requests.

To use it, start the server and send MCP requests to the configured endpoints. Endpoints are defined by the MCP server and typically map to specific Unusual Whales resources (for example, quotes, chains, or option data). You can structure your MCP queries to fetch data, apply filters, and paginate results as supported by the MCP interface implemented by this server. If you need to access a key Unusual Whales resource, consult the server’s available endpoints and example queries to construct valid MCP requests.

Prerequisites:

• Node.js (14.x or newer) and npm installed on your system.
• Access to Unusual Whales API with a valid API key.

Installation steps:

1. Clone the repository: git clone https://github.com/your-org/mcp-server-unusualwhales.git
2. Navigate to the project directory: cd mcp-server-unusualwhales
3. Install dependencies: npm install
4. Configure environment variables (preferred):
   • Create a .env file or export variables in your shell: UNUSUAL_WHALES_API_KEY=your-api-key UNUSUAL_WHOLES_BASE_URL=https://api.unusualwhales.com
5. Start the server: node server.js (Alternatively use npm start if a start script is defined in package.json)
6. Verify the server is running by sending a test MCP request to the exposed endpoint.

Environment variables:

• UNUSUAL_WHALES_API_KEY: Your Unusual Whales API key. Required for authenticated requests.
• UNUSUAL_WHALES_BASE_URL: Base URL for the Unusual Whales REST API. Default typically https://api.unusualwhales.com. Common issues:
• Missing or invalid API key will lead to 401 errors from Unusual Whales.
• Ensure network access to the Unusual Whales API; if behind a firewall, allow outbound traffic to the API domain.
• If the MCP server exposes rate-limiting options, configure them to avoid hitting Unusual Whales limits.
• Check server logs for endpoint mappings if a requested resource is not found; the MCP layer may expose a subset of Unusual Whales endpoints.