valenbisi-mcp

<div align="center">

MCP server for the Valenbisi bike-share system in Valencia

*Ask your AI assistant to check bike availability, find a bike, or unlock one — right from the chat*

<p> </p>

</div>

---

Connect your AI assistant to Valenbisi. Ask which stations have bikes, locate a specific bike by number, or unlock a bike — all through natural conversation.

1. Install

curl -sSL https://galimru.github.io/valenbisi-mcp/install.sh | sh

Or download a binary from the releases page.

2. Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "valenbisi": {
      "command": "/path/to/valenbisi-mcp",
      "env": {
        "VALENBISI_EMAIL": "you@example.com",
        "VALENBISI_PASSWORD": "123456"
      }
    }
  }
}

On first run the server logs in and caches the session to disk. Subsequent starts reuse the saved token and only re-authenticate when it expires.

| Tool | What it does | |------|--------------| | get_nearest_stations | Nearest stations to a GPS location, sorted by distance | | get_nearest_stations_with_bikes | Nearest open stations that have bikes available to rent | | get_nearest_stations_with_stands | Nearest open stations that have free docks to return a bike | | get_station | Details for a single station by number | | get_bike | Look up a bike by number — returns its current station and dock | | unlock_bike | Unlock a bike (requires your GPS coordinates; enforces a proximity check) | | get_profile | Your account profile | | get_trips | You