Transport
Data source: GBFS (General Bikeshare Feed Specification) — city operators
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/gbfs/
claude_desktop_config.json
{
"mcpServers": {
"gnist-gbfs": {
"url": "https://context.gnist.ai/mcp/gbfs/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/gbfs/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_system_info", "arguments": {"system_id": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/gbfs/
5 endpoints available:
GET /rest/gbfs/list_systemsGET /rest/gbfs/get_system_infoGET /rest/gbfs/get_stationsGET /rest/gbfs/get_station_statusGET /rest/gbfs/report_feedback
Shell
curl "https://context.gnist.ai/rest/gbfs/get_system_info?system_id=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/gbfs/get_system_info",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"system_id": "example"
},
)
print(resp.json())
Command Line
Command
gc gbfs
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (5)
list_systemsList available bikeshare/scooter systems from the catalog.
| Parameter | Type | Required | Description |
|---|---|---|---|
country | any | optional | ISO 3166-1 alpha-2 country code to filter systems (e.g. "NO", "US", "GB", "FR"). |
query | any | optional | Text search across system name, city, and operator (e.g. 'Oslo', 'Lime', 'Citi Bike'). |
limit | integer | optional | Maximum systems to return (1-100, default 50). (default: 50) |
get_system_infoGet metadata for a specific bikeshare system.
| Parameter | Type | Required | Description |
|---|---|---|---|
system_id | string | required | System identifier from list_systems (e.g. "oslobysykkel", "lyft_nyc", "divvy"). |
get_stationsGet stations with real-time bike/dock availability for a bikeshare system.
| Parameter | Type | Required | Description |
|---|---|---|---|
system_id | string | required | System identifier from list_systems (e.g. "oslobysykkel", "lyft_nyc"). |
query | any | optional | Text filter on station name or address (e.g. 'Central Station', 'Main St'). |
limit | integer | optional | Maximum stations to return (1-100, default 50). (default: 50) |
get_station_statusGet real-time availability for a specific bikeshare station.
| Parameter | Type | Required | Description |
|---|---|---|---|
system_id | string | required | System identifier from list_systems (e.g. "oslobysykkel", "lyft_nyc"). |
station_id | string | required | Station identifier from get_stations results. |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |