Provides tools for querying OpenStreetMap tagging schema, discovering presets, validating tags, checking for deprecated tags, and suggesting tag improvements using the official @openstreetmap/id-tagging-schema library.
OpenStreetMap Tagging Schema MCP Server
What is this?
This is a Model Context Protocol (MCP) server designed specifically for AI agents and LLM applications. It acts as a bridge between artificial intelligence systems and the comprehensive OpenStreetMap tagging knowledge base provided by the official @openstreetmap/id-tagging-schema library.
Current Status: Production-ready MCP server, actively maintained and continuously improved. The service is deployed and accessible at https://mcp.gander.tools/osm-tagging/.
We welcome your feedback! Have ideas for improvements? Found a bug? Want to discuss features? Please open an issue or start a discussion.
What this is NOT
ā ļø Important clarifications:
Not a standalone application: This server requires integration with AI systems (like Claude Code or Claude Desktop) to be useful. It has no user interface or web frontend.
Not for direct human use: Without an AI agent as an intermediary, this tool provides no value to end users. It's designed exclusively for programmatic access by LLM applications.
Not a public API for general use: The deployed service at mcp.gander.tools is intended for integration with AI agents, not for direct HTTP requests or high-volume automated queries. Please do not attempt to abuse the service with DDoS attacks or excessive traffic.
If you're looking for a user-facing OSM tagging tool, consider iD editor or JOSM instead.
Features
7 MCP Tools organized into 3 categories:
Tag Query (2 tools): Query tag values and search tags
Preset Discovery (2 tools): Search and explore OSM presets with detailed configurations
Validation (3 tools): Validate tags, check for deprecated tags, suggest improvements
š Full tool reference: docs/api/
Installation
Using npx (Recommended)
Using Docker
š More options: docs/user/installation.md (source installation, verification, troubleshooting)
Quick Start
With Claude Code CLI
With Claude Desktop
Add to your Claude Desktop configuration:
š Next steps:
Configuration Guide - Setup for Claude Code/Desktop and custom clients
Usage Guide - Tool examples and workflows
API Reference - Complete tool documentation
Deployment Guide - Production HTTP/Docker deployment
Testing with MCP Inspector
Test and debug the server using the official MCP Inspector:
The Inspector provides an interactive web UI to test all tools, inspect responses, and debug issues.
š Complete inspection guide: docs/development/inspection.md (includes HTTP transport testing)
Development
Built with Test-Driven Development (TDD) and Property-Based Fuzzing:
Comprehensive test suite (unit + integration) with 100% pass rate
Property-based fuzz tests with fast-check for edge case discovery
Continuous fuzzing in CI/CD (weekly schedule + on every push/PR)
š Development guides: docs/development/development.md | docs/development/fuzzing.md
Contributing
Contributions welcome! This project follows Test-Driven Development (TDD).
Fork and clone the repository
Install dependencies:
npm installCreate a feature branch
Write tests first, then implement
Ensure all tests pass:
npm testSubmit a pull request
š Guidelines: docs/development/contributing.md
Documentation
Quick Navigation
Choose your path:
I want to... | Go to |
Install and run the server | |
Configure with Claude Code/Desktop | |
Learn how to use the tools | |
Test and debug the server | |
Deploy in production (HTTP/Docker) | |
Fix issues or errors | |
Contribute to the project |
Complete Documentation
User Guides:
Installation - Setup guide (npx, Docker, source)
Configuration - Claude Code/Desktop configuration
Usage - Tool examples and workflows
API Reference - Complete tool documentation
Troubleshooting - Common issues and solutions
Developer Docs:
Contributing - Contribution guidelines (TDD workflow)
Development - Development setup and debugging
Inspection - MCP Inspector testing guide
Fuzzing - Security fuzzing and property testing
Roadmap - Project roadmap and future features
Release Process - Release and publishing workflow
Deployment Docs:
Deployment - HTTP/Docker production deployment
Security - Security features, provenance, and SLSA
Project Info:
CHANGELOG.md - Version history
License
GNU General Public License v3.0 - See LICENSE file for details.