Back to Browse

Pinsharing MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Geocoding, static maps and privacy-safe area maps from OpenStreetMap data. Hard caps, no overage.

About

Geocoding, static maps and privacy-safe area maps from OpenStreetMap data. Hard caps, no overage.

Remote endpoints: streamable-http: https://api.pinsharing.com/v1/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

5 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

env_vars

Applies to the server that hosts this plugin, not to your machine.

file_system

Applies to the server that hosts this plugin, not to your machine.

Shell Command Execution

Runs commands on the server that hosts it, not on your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

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

Documentation

View on GitHub

From the project's GitHub README.

PinSharing MCP

PinSharing (https://pinsharing.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.pinsharing/maps

Most clients: use the hosted server directly

The hosted MCP server is available at:

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

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

claude mcp add --transport http pinsharing https://api.pinsharing.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": {
    "pinsharing": {
      "command": "npx",
      "args": ["-y", "github:Software-Consulting/pinsharing-mcp"],
      "env": { "PINSHARING_API_KEY": "ps_your_key" }
    }
  }
}

Git and Node.js 18+ are required. An npm package (@pinsharing/mcp) is coming.

Tools

ToolWhat it doesWhat it counts
geocodeConvert addresses or place names to coordinates1 geocode
reverse_geocodeConvert coordinates to an address or place1 geocode
static_mapRender a map image with markers or a route1 static image
privacy_area_mapShow roughly where a place is (a shaded area, no pin); never reveals the exact point1 static image
map_setupCode and URLs for an interactive map (MapLibre GL JS, Leaflet, OpenLayers)free

Configuration

VariableRequiredDefaultDescription
PINSHARING_API_KEYRecommendednonePinSharing API key (ps_...). Without it, discovery works and tool calls return the server's missing_key error.
PINSHARING_MCP_URLNohttps://api.pinsharing.com/v1/mcpHosted MCP server URL. Must be https: unless the host is localhost or 127.0.0.1.
PINSHARING_MCP_TIMEOUT_MSNo60000HTTP timeout in milliseconds.
PINSHARING_MCP_DEBUGNounsetSet to 1 to write debug logs to stderr.

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 api.pinsharing.com in the Authorization header, and never printed in logs or errors.

Plans and caps

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

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. PinSharing is a service of Wells Software Consulting LLC.

Reviews

No reviews yet

Be the first to review this server!