home / mcp / price service mcp server

Price Service MCP Server

Provides real-time and historical cryptocurrency price data via MCP by querying BitwaveCorp price service API.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bitwavecorp-price-service-mcp": {
      "url": "https://price-svc-utyjy373hq-uc.a.run.app"
    }
  }
}

You run a Price Service MCP server that fetches real-time and historical cryptocurrency prices by querying BitwaveCorp’s price service API. It provides easy access to price data across multiple exchanges and fiat currencies, with configurable time resolutions and optional historical lookups. This makes it simple to power dashboards, alerts, or trading strategies with accurate price information.

How to use

You interact with the Price Service MCP through an MCP client. Use the get_price tool to fetch current or historical prices for a given cryptocurrency. You can specify the exchange service, target fiat currency, desired time resolution, and an optional timestamp for historical data. Use health_check to verify that the MCP server and the underlying price service are operational.

Typical usage patterns include selecting a cryptocurrency like BTC or ETH, choosing a price service such as coinbase, binance, or kraken, and setting the desired fiat currency (e.g., USD). You can request different resolutions like 1m, 5m, 15m, 1h, 4h, or 1d to suit your display or analysis needs. For historical data, provide a Unix timestamp to retrieve the price at a specific moment.

To ensure your integration remains healthy, periodically run health_check to confirm both the MCP server and the price service are responding. If you encounter issues, verify that you are pointing to the correct MCP URL and that your environment can access the remote price service endpoint.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Install dependencies and build the project.

npm install
npm run build

Run in development mode to test locally.

npm run dev

For production, build once and then start the server.

npm run build
npm start

Additional configuration and notes

The MCP server connects to a remote price service endpoint to retrieve price data. The remote endpoint used is https://price-svc-utyjy373hq-uc.a.run.app. Use this URL in your MCP client configuration to route requests correctly.

You can configure an MCP client to point to this server by defining an HTTP MCP connection with the provided URL and no additional arguments.

{
  "mcpServers": {
    "price_service": {
      "type": "http",
      "name": "price_service",
      "url": "https://price-svc-utyjy373hq-uc.a.run.app",
      "args": []
    }
  }
}

Available tools

get_price

Retrieve cryptocurrency price data with optional parameters such as fromSym, service, timestampSEC, resolution, and toFiat to fetch prices from the configured price service.

health_check

Check the health status of the MCP server and the underlying price service to ensure they are operating correctly.