# Geolocation MCP Server
A Model Context Protocol server that provides geolocation services including WalkScore API integration for walkability, transit, and bike scores.
## Features
- **Transit Stops**: Find nearby transit stops for any location
- **WalkScore**: Get walkability scores for any address
- **TransitScore**: Get public transit accessibility scores
- **BikeScore**: Get bikeability scores for locations
- **Location-based**: Works with addresses, coordinates, or both
## Available Tools
- `get_transit_stops` - Get nearby transit stops for a location
- `get_walkscore` - Get WalkScore, TransitScore, and BikeScore for a location
## Quick Start
1. **Get a WalkScore API key** from [walkscore.com/professional/api.php](https://www.walkscore.com/professional/api.php)
2. **Install the server**: `uvx mcp-server-geolocation`
3. **Configure your MCP client** (see Configuration section below)
4. **Start using the tools** in your MCP-compatible application
## Configuration
You'll need a WalkScore API key from [walkscore.com/professional/api.php](https://www.walkscore.com/professional/api.php).
### Configure for Claude.app
Add to your Claude settings:
```json
{
"mcpServers": {
"geolocation": {
"command": "uvx",
"args": ["mcp-server-geolocation"],
"env": {
"WALKSCORE_API_KEY": "your_api_key_here"
}
}
}
}
```
### Configure for VS Code
Add to your VS Code settings:
```json
{
"mcp": {
"servers": {
"geolocation": {
"command": "uvx",
"args": ["mcp-server-geolocation"],
"env": {
"WALKSCORE_API_KEY": "your_api_key_here"
}
}
}
}
}
```
## Usage
Once configured, the server provides two main tools:
### `get_transit_stops`
Find nearby transit stops for any location:
- **Input**: Latitude and longitude coordinates
- **Output**: List of nearby transit stops with routes and distances
### `get_walkscore`
Get walkability scores for any location:
- **WalkScore**: Measures how walkable a location is (0-100)
- **TransitScore**: Measures public transit accessibility (0-100)
- **BikeScore**: Measures bikeability (0-100)
**Input options**:
- An address (string) - e.g., "123 Main St, Seattle, WA"
- Latitude and longitude coordinates - e.g., 47.6085, -122.3295
- Both address and coordinates for better accuracy
**Example usage in Claude**:
- "Find transit stops near 40.7136, -73.9909"
- "What's the walkability score for 123 Main St, Seattle, WA?"
## Installation
### Using uv (recommended)
```bash
uvx mcp-server-geolocation
```
### Using pip
```bash
pip install mcp-server-geolocation
```
## License
MIT License - see LICENSE file for details.
