{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zwfwcjmdt58r","handle":"geocode-mcp","url":"https://wellknown.network/agents/geocode-mcp","links":{"self":"https://wellknown.network/agents/geocode-mcp/record.json","html":"https://wellknown.network/agents/geocode-mcp","markdown":"https://wellknown.network/agents/geocode-mcp/record.md","api":"https://wellknown.network/api/v1/agents/geocode-mcp","status":"https://wellknown.network/api/v1/agents/geocode-mcp/status","claim":"https://wellknown.network/agents/geocode-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/geocode-mcp/claim.json","badge":"https://wellknown.network/agents/geocode-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/geocode-mcp/history","tools":"https://wellknown.network/api/v1/agents/geocode-mcp/tools"},"ard":{"identifier":"urn:air::server:geocode-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"geocode-mcp","summary":"MCP server for producing latitude/longitude coordinates for cities and areas using OpenStreetMap Nominatim API","description":"# Geocode MCP Server\n\nA Model Context Protocol (MCP) server that provides latitude/longitude coordinates for cities and locations using the OpenStreetMap Nominatim API.\n\n## Features\n\n- 🌍 **Global Geocoding**: Get coordinates for any location worldwide\n- 🆓 **Free API**: Uses OpenStreetMap Nominatim (no API key required)\n- � **MCP Integration**: Works with Cursor, VS Code, Claude Desktop, and other MCP-compatible tools\n- 📦 **Easy Installation**: Install via PyPI with `uvx geocode-mcp`\n- �️ **Modern Tooling**: Built with Python 3.12+, async/await, and comprehensive testing\n\n## Quick Start\n\n### Installation\n\nInstall the package from PyPI using uvx (recommended):\n\n```bash\nuvx geocode-mcp\n```\n\nOr install with pip:\n\n```bash\npip install geocode-mcp\n```\n\n### MCP Configuration\n\nAdd to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"geocoding\": {\n      \"command\": \"uvx\",\n      \"args\": [\"geocode-mcp\"]\n    }\n  }\n}\n```\n\nSee the [`config/`](config/) directory for specific examples for different tools.\n\n## Available Tools\n\n### `mcp_geocoding_get_coordinates`\n\nGet latitude and longitude coordinates for a city or location.\n\n**Parameters:**\n- `location` (required): City name, address, or location (e.g., \"New York\", \"Paris, France\", \"123 Main St, Seattle\")\n- `limit` (optional): Maximum number of results to return (default: 1, max: 10)\n\n**Example Usage:**\n```\nGet coordinates for Tokyo, Japan\nFind the latitude and longitude of London, UK  \nWhat are the coordinates for New York City?\nGet coordinates for \"1600 Pennsylvania Avenue, Washington DC\" with limit 5\n```\n\n**Response Format:**\n```json\n{\n  \"query\": \"Tokyo, Japan\",\n  \"results_count\": 1,\n  \"coordinates\": [\n    {\n      \"latitude\": 35.6762,\n      \"longitude\": 139.6503,\n      \"display_name\": \"Tokyo, Japan\",\n      \"place_id\": \"282885117\",\n      \"type\": \"city\",\n      \"class\": \"place\",\n      \"importance\": 0.9,\n      \"bounding_box\": {\n        \"south\": 35.619,\n        \"north\": 35.739,\n        \"west\": 139.619,\n        \"east\"…","publisher":null,"homepage":"https://github.com/X-McKay/geocode-mcp#readme","repository":"https://github.com/X-McKay/geocode-mcp#readme","version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["coordinates","latitude","longitude","mcp","openstreetmap"],"pricing":null,"endpoints":[{"url":"pypi:geocode-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"geo.maps","name":"Maps & Places","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","geo"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"geocode-mcp","registry":"pypi","observedAt":"2026-11-09T05:25:03.433Z","publishedAt":"2025-07-02T04:20:40.981724Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"geocode-mcp","url":"https://pypi.org/project/geocode-mcp/","firstSeenAt":"2026-09-09T16:23:36.598Z","fetchedAt":"2026-11-09T05:24:08.594Z","normalizedAt":"2026-11-09T05:24:08.594Z"}]},"firstSeenAt":"2026-09-09T16:23:36.598Z","updatedAt":"2026-11-09T05:25:03.433Z"}