bizidashboard-mcp

MCP server exposing BiziDashboard's historical and analytical data for the Zaragoza Bizi bike-share system as tools for LLM clients.

Unlike the official GBFS feed (which only exposes the current state of the system), BiziDashboard stores and analyzes history: rankings, occupancy patterns, mobility signals, alert history, and a station rebalancing diagnostic report. This server makes that analytical layer easy to query from Claude Desktop or any other MCP client.

Installation

Published on npm — no cloning or compiling required. Add it to your MCP client config (e.g. claude_desktop_config.json):

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

From source

git clone https://github.com/gcaguilar/bizidashboard-mcp.git
cd bizidashboard-mcp
npm install
npm run build

Then point your MCP client at the built entrypoint:

{
  "mcpServers": {
    "bizidashboard": {
      "command": "node",
      "args": ["/absolute/path/to/bizidashboard-mcp/dist/index.js"]
    }
  }
}

Related MCP server: Spanish Public Data MCP

Configuration

Both variables are optional.

Tools

Every tool returns the API's JSON response as-is (or CSV text when format: "csv" is requested); nothing is summarized or transformed. Errors from the underlying API (bad params, rate limits, missing key) surface as MCP tool errors with the original status and message.

Development

npm run build       # compile TypeScript to dist/
npm run typecheck   # type-check without emitting
npm test            # build, then run integration tests against the live public API

Tests hit https://datosbizi.com for real — there are no mocks. A couple of tests are skipped automatically if BIZI_PUBLIC_API_KEY is not set, since they'd otherwise require a real elevated-access key to assert success.