MapIron MCP server

Q: How do I add MapIron MCP to Claude Code?

Run `claude mcp add --transport http maps https://api.pinsharing.com/v1/mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add MapIron MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Nov 9, 2026

software-consulting/maps · javascript · MIT

Provides geocoding, static map images, and privacy-safe area maps using OpenStreetMap data.

Also known as Software-Consulting/mapiron-mcp, maps

remote 5 tools Search & Web Data

Install GitHub ↗

Stars: 0
Tools: 5
Downloads, 30 days: —
Latest version: 1.0.3
Last commit: Nov 9, 2026
License: MIT

What is MapIron MCP?

MapIron provides geocoding, static map images, and privacy-safe area maps using OpenStreetMap data. It exposes 5 tools, such as geocode, reverse_geocode, static_map.

Summary generated from the project's README

About MapIron MCP server

MapIron provides developers with access to OpenStreetMap data through a suite of mapping tools. It allows for geocoding addresses into coordinates, performing reverse geocoding, and generating static map images. A unique privacy-area-map tool can display shaded regions instead of exact pins to protect specific locations. Users can also generate code and URLs for interactive maps using MapLibre GL JS, Leaflet, or OpenLayers.

This server can be used as a hosted HTTP service or via a local stdio bridge for clients like Claude Desktop. To use the hosted version, you provide an Authorization header with your API key. For local setups using npx, you must configure the MAPIRON_API_KEY environment variable. The service operates on a model with a free plan and flat paid plans that include monthly caps without overage billing.

What you can do with it

1Convert addresses to coordinatesAsk the AI to find the latitude and longitude for a specific street address.
2Generate privacy-safe location visualsRequest a map that shows a general area without revealing an exact point.
3Create static map imagesHave the AI render a map image that includes specific markers or a travel route.
4Build interactive web mapsRequest the necessary code and URLs to implement a map using Leaflet or OpenLayers.

Written from the project's README. Every use case is checked against a quote from it.

How to install MapIron MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeCodexGemini CLI

$ claude mcp add --transport http maps https://api.pinsharing.com/v1/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "maps": {
      "url": "https://api.pinsharing.com/v1/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "maps": {
      "type": "http",
      "url": "https://api.pinsharing.com/v1/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.maps]
url = "https://api.pinsharing.com/v1/mcp"

~/.gemini/settings.json

{
  "mcpServers": {
    "maps": {
      "httpUrl": "https://api.pinsharing.com/v1/mcp"
    }
  }
}

Set 1 environment variable before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

MapIron MCP tools 5

Detected from the README

geocode
reverse_geocode
static_map
privacy_area_map
map_setup

geocode	—
reverse_geocode	—
static_map	—
privacy_area_map	—
map_setup	—

Configuration

MAPIRON_API_KEY

Name	Description
MAPIRON_API_KEY	—

Automated checks

Ran Nov 14, 2026Full report →

75/100

Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work

Show this score in your README

Source repository linked and reachablesoftware-consulting/mapiron-mcp is public and reachablegithub.com/software-consulting/mapiron-mcp ↗Pass
Package names this repository as its sourceNot checked
Build provenance (Sigstore attestation)Not checked
Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
Commit or release in the last yearLast commit or release 2026-11-09github.com/software-consulting/mapiron-mcp ↗Pass
OpenSSF ScorecardNot checked
Package name not close to a popular packageNot checked
No critical advisory in the package or its dependenciesNot checked
No hidden instructions to the model5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
Destructive tools are labelledNo tool named like delete, drop or execPass
Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 258 msPass

README

View on GitHub

MapIron MCP

MapIron (https://mapiron.com) is a map API built on OpenStreetMap data, with a free plan and flat paid plans. It provides static map images, including a privacy-area mode, geocoding, and tiles. This repository provides a small stdio-to-HTTP bridge for MCP clients that can only launch local servers.

MCP Registry: com.mapiron/maps

MapIron was called PinSharing until November 2026. Old configs keep working: see Upgrading from PinSharing.

Most clients: use the hosted server directly

The hosted MCP server is available at:

https://api.mapiron.com/v1/mcp

See https://mapiron.com/docs/mcp for setup. With Claude Code:

claude mcp add --transport http mapiron https://api.mapiron.com/v1/mcp --header "Authorization: Bearer YOUR_KEY"

Clients that only run local servers (stdio)

Some clients, such as Claude Desktop with claude_desktop_config.json, can only launch local stdio MCP servers. For those, use this bridge.

{
  "mcpServers": {
    "mapiron": {
      "command": "npx",
      "args": ["-y", "github:Software-Consulting/mapiron-mcp"],
      "env": { "MAPIRON_API_KEY": "ps_your_key" }
    }
  }
}

Git and Node.js 18+ are required.

Tools

Tool	What it does	What it counts
`geocode`	Convert addresses or place names to coordinates	1 geocode
`reverse_geocode`	Convert coordinates to an address or place	1 geocode
`static_map`	Render a map image with markers or a route	1 static image
`privacy_area_map`	Show roughly where a place is (a shaded area, no pin); never reveals the exact point	1 static image
`map_setup`	Code and URLs for an interactive map (MapLibre GL JS, Leaflet, OpenLayers)	free

Configuration

Variable	Required	Default	Description
`MAPIRON_API_KEY`	Recommended	none	MapIron API key (`ps_...`). Without it, discovery works and tool calls return the server's `missing_key` error.
`MAPIRON_MCP_URL`	No	`https://api.mapiron.com/v1/mcp`	Hosted MCP server URL. Must be `https:` unless the host is `localhost` or `127.0.0.1`.
`MAPIRON_MCP_TIMEOUT_MS`	No	`60000`	HTTP timeout in milliseconds.
`MAPIRON_MCP_DEBUG`	No	unset	Set to `1` to write debug logs to stderr.

Upgrading from PinSharing

Nothing breaks if you change nothing:

github:Software-Consulting/pinsharing-mcp redirects to this repository.
PINSHARING_API_KEY, PINSHARING_MCP_URL, PINSHARING_MCP_TIMEOUT_MS and PINSHARING_MCP_DEBUG are still read. If both names are set, the MAPIRON_ one wins.
Existing ps_ keys work unchanged, and https://api.pinsharing.com/v1/mcp still serves the same tools.

To move to the new names, change the repository in args to github:Software-Consulting/mapiron-mcp and rename the variable to MAPIRON_API_KEY.

How it works

The bridge reads JSON-RPC messages from stdin, one per line, and forwards each one to the hosted MCP server over HTTPS. Responses are written to stdout, one JSON object per line. Nothing is stored locally. The API key is only sent to the configured server (by default api.mapiron.com) in the Authorization header, and never printed in logs or errors.

Plans and caps

MapIron has hard monthly caps and no overage billing. A free plan is available without a card:

Pricing and caps: https://mapiron.com/pricing
Free keys / dashboard: https://mapiron.com/dashboard

Attribution

Map data © OpenStreetMap contributors. Show attribution wherever map results or images appear.

Development

npm test

The project has zero runtime or development dependencies.

License

MIT. MapIron is a service of Wells Software Consulting LLC.

Read full README

MapIron MCP questions

How do I add MapIron MCP to Claude Code?

Run claude mcp add --transport http maps https://api.pinsharing.com/v1/mcp in your terminal. Add --scope user to make it available in every project.

How do I add MapIron MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does MapIron MCP provide?

It exposes 5 tools, including geocode, reverse_geocode, static_map, privacy_area_map, map_setup.

How can I use MapIron with Claude Desktop?

You can use the stdio bridge by adding the server to your claude_desktop_config.json using npx and providing your MAPIRON_API_KEY.

What is the privacy-area map tool?

The privacy_area_map tool shows a shaded area representing a location without revealing the exact point or using a pin.

Can I use my old PinSharing API keys?

Yes, existing ps_ keys work unchanged and the old configuration variables are still supported.

Facts

Nov 13, 2026

Stars: 0
Downloads, 30 days: —
Latest version: 1.0.3
Last commit: Nov 9, 2026
License: MIT
Transport: remote
Package: —

Software-Consulting ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/software-consulting/maps.svg)](https://hostedmcp.org/servers/software-consulting/maps/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About MapIron MCP server

What you can do with it

1Convert addresses to coordinatesAsk the AI to find the latitude and longitude for a specific street address.
2Generate privacy-safe location visualsRequest a map that shows a general area without revealing an exact point.
3Create static map imagesHave the AI render a map image that includes specific markers or a travel route.
4Build interactive web mapsRequest the necessary code and URLs to implement a map using Leaflet or OpenLayers.

Written from the project's README. Every use case is checked against a quote from it.

Name

Description

MAPIRON_API_KEY

—

Tool

What it does

What it counts

geocode

Convert addresses or place names to coordinates

1 geocode

reverse_geocode

Convert coordinates to an address or place

1 geocode

static_map

Render a map image with markers or a route

1 static image

privacy_area_map

Show roughly where a place is (a shaded area, no pin); never reveals the exact point

1 static image

map_setup

Code and URLs for an interactive map (MapLibre GL JS, Leaflet, OpenLayers)

free

Variable

Required

Default

Description

MAPIRON_API_KEY

Recommended

none

MapIron API key (ps_...). Without it, discovery works and tool calls return the server's missing_key error.

MAPIRON_MCP_URL

https://api.mapiron.com/v1/mcp

Hosted MCP server URL. Must be https: unless the host is localhost or 127.0.0.1.

MAPIRON_MCP_TIMEOUT_MS

60000

HTTP timeout in milliseconds.

MAPIRON_MCP_DEBUG

unset

Set to 1 to write debug logs to stderr.

MapIron MCP questions

How do I add MapIron MCP to Claude Code?

Run claude mcp add --transport http maps https://api.pinsharing.com/v1/mcp in your terminal. Add --scope user to make it available in every project.

How do I add MapIron MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What tools does MapIron MCP provide?

It exposes 5 tools, including geocode, reverse_geocode, static_map, privacy_area_map, map_setup.

How can I use MapIron with Claude Desktop?

You can use the stdio bridge by adding the server to your claude_desktop_config.json using npx and providing your MAPIRON_API_KEY.

What is the privacy-area map tool?

The privacy_area_map tool shows a shaded area representing a location without revealing the exact point or using a pin.

Can I use my old PinSharing API keys?

Yes, existing ps_ keys work unchanged and the old configuration variables are still supported.

MapIron MCP server

What is MapIron MCP?

About MapIron MCP server

What you can do with it

How to install MapIron MCP

Install MapIron MCP in Claude Code

Install MapIron MCP in Cursor

Install MapIron MCP in VS Code

Install MapIron MCP in Codex

Install MapIron MCP in Gemini CLI

MapIron MCP tools 5

Configuration

Automated checks

README

MapIron MCP

Most clients: use the hosted server directly

Clients that only run local servers (stdio)

Tools

Configuration

Upgrading from PinSharing

How it works

Plans and caps

Attribution

Development

License

MapIron MCP questions

MapIron MCP server

What is MapIron MCP?

About MapIron MCP server

What you can do with it

How to install MapIron MCP

Install MapIron MCP in Claude Code

Install MapIron MCP in Cursor

Install MapIron MCP in VS Code

Install MapIron MCP in Codex

Install MapIron MCP in Gemini CLI

MapIron MCP tools 5

Configuration

Automated checks

README

MapIron MCP

Most clients: use the hosted server directly

Clients that only run local servers (stdio)

Tools

Configuration

Upgrading from PinSharing

How it works

Plans and caps

Attribution

Development

License

MapIron MCP questions