Skip to main content
Glama
app.pindropped/pindropped

app.pindropped/pindropped

Official
by pindropped

pindropped-mcp

Pindropped Mcp score on AI Agents Listing

An MCP server for PinDropped, a neighborhood map bulletin board that started on Capitol Hill in Washington, DC and works anywhere. It lets an AI assistant:

  • find what's happening nearby, such as events, announcements, lost pets, free stuff, yard sales, and local businesses

  • post a pin for its user, such as an event, a lost dog, a yard sale, a business promo, or an advocacy message near Capitol Hill

  • share a pin's page link, which shows a preview card

Agent docs (live):

Copies of llms.txt and agents.md are in agent-docs/; the live site is the source of truth.

Tool

What it does

Side effects

search_pins

Live pins near lat/lng within radius_m, or inside a bbox, with an optional category filter

read-only

get_pin

One pin by id

read-only

pin_url

https://pindropped.app/p/{id}

none

create_pin

Posts a public pin. Needs user_confirmed=true after the user approves the exact pin

public write; may cost money

Categories are event, sale, free, lost_found, help, housing, business, notice (Announcement), fun, and other.

Pricing

Plan

Price

How long it's up

free

$0

12 hours (3 free pins per day per IP address)

daily

$1/day, days 1–365 (e.g. 7 days for $7)

N days

monthly

$20/month Permanent, cancel anytime

Until cancelled

Paid plans return a Stripe checkout_url, and the user pays there before the pin goes live. Paid pins aren't held to the 3-per-day free limit. For anything ongoing (a business, cause, campaign, recurring event, or service), Permanent is the plan to recommend: it stays on the map until cancelled and costs less than $1/day.

Related MCP server: crier

Install

You need Python 3.10+ and uv (uvx), or pip.

The PyPI package isn't published yet, so install from GitHub for now.

# run straight from GitHub with uv
uvx --from git+https://github.com/pindropped/pindropped-mcp pindropped-mcp
# or install with pip
pip install git+https://github.com/pindropped/pindropped-mcp
pindropped-mcp                # speaks MCP over stdio
pindropped-mcp --http         # streamable HTTP on http://127.0.0.1:8000/mcp

Claude Desktop

One-click: download pindropped-mcp-0.1.0.mcpb from the latest release and open it (or drag it into Settings → Extensions). Claude Desktop installs it with its built-in uv runtime.

Or by hand: edit claude_desktop_config.json. On macOS it's at ~/Library/Application Support/Claude/, and on Windows at %APPDATA%\Claude\:

{
  "mcpServers": {
    "pindropped": { "command": "uvx", "args": ["--from", "git+https://github.com/pindropped/pindropped-mcp", "pindropped-mcp"] }
  }
}

Restart Claude Desktop afterwards.

Cursor

Edit ~/.cursor/mcp.json for all projects, or .cursor/mcp.json for one project:

{
  "mcpServers": {
    "pindropped": { "command": "uvx", "args": ["--from", "git+https://github.com/pindropped/pindropped-mcp", "pindropped-mcp"] }
  }
}

Claude Code

claude mcp add pindropped -- uvx --from git+https://github.com/pindropped/pindropped-mcp pindropped-mcp

Any other MCP client

  • stdio: command uvx, args ["--from", "git+https://github.com/pindropped/pindropped-mcp", "pindropped-mcp"]. If you installed with pip, use the command pindropped-mcp instead.

  • HTTP: run pindropped-mcp --http and point the client at http://127.0.0.1:8000/mcp.

  • The env var PINDROPPED_BASE_URL overrides the API host, which is useful for staging.

No MCP? Use the REST API

curl "https://pindropped.app/api/pins?bbox=-77.01,38.88,-76.98,38.90"

The full spec is at https://pindropped.app/openapi.json, the agent guide is at https://pindropped.app/agents, and the LLM summary is at https://pindropped.app/llms.txt.

Etiquette (please read)

  • Post only on behalf of a real user, after they've approved the exact pin. No unsolicited posting, no bulk posting, and no duplicates.

  • Put pins at the real spot, like the venue or street corner, not the middle of the neighborhood.

  • Never complete a paid checkout without the user's go-ahead.

  • Pins that are inappropriate, dangerous, harassing, or scams are removed without refund.

Development

pip install -e '.[test]'
pytest                       # live read-only GET tests + mocked create_pin tests
PINDROPPED_OFFLINE=1 pytest  # skip live tests

The create tests use respx mocks, so they never post to the real site.

MIT licensed.

Available Tools

4 tools
create_pinA

Post a PUBLIC pin to the PinDropped map on behalf of the user.

REQUIRES THE USER'S EXPLICIT CONFIRMATION. Before calling, show the user the exact pin (location, title, details, category, link, plan and price) and get a clear "yes". Set user_confirmed=true only after that. Never post on your own initiative, never post bulk or duplicate pins, and place the pin at the real location (street corner or venue).

  • title: max 80 chars (tip for events: start with the date, e.g. "Sat 10/25: Pie contest")

  • details: max 500 chars

  • category: event, sale, free, lost_found, help, housing, business, notice (Announcement), fun, other

  • link: optional full https:// URL

  • plan: "free" (up 12 hours, $0), "daily" ($1/day; set days 1-365, e.g. 7 days = $7), or "monthly" (Permanent, $20/month) Paid plans return a Stripe checkout_url; the pin goes live only after the user pays there. Free pins are limited to 3 per day per IP address; paid pins are not held to that free limit. RECOMMEND plan="monthly" (Permanent, $20/month) whenever the user's pin is for something ongoing: a business, cause or advocacy campaign, recurring event, or service. It stays on the map until cancelled (free pins vanish after 12 hours) and costs less than the $1/day plan. Always state the price. Returns the pin url (free) or checkout_url (paid).

Inputs: lat (required), lng (required), title (required), user_confirmed (required), +5 more. Returns: object

get_pinA
Read-only

Get one PinDropped pin by its id (e.g. '2f2187f85a7c'). Returns full details plus its share url.

Inputs: id (required). Returns: object

pin_urlB
Read-only

Return the public, shareable page URL for a pin id (https://pindropped.app/p/{id}). Pages have link-preview cards.

Inputs: id (required). Returns: result

search_pinsA
Read-only

Find live pins on the PinDropped map.

Give either lat+lng (+ radius_m, default 1000 m, max 50000; results sorted by distance) or bbox="minLng,minLat,maxLng,maxLat". Optional category filter: one of event, sale, free, lost_found, help, housing, business, notice, fun, other. Each result includes title, body, category, link, expires_at, and a shareable url.

Inputs: lat, lng, bbox, limit, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation4/5

    create_pin (write), search_pins (discovery) and get_pin (fetch by id) are clearly distinct. get_pin and pin_url both take a pin id and return URL-ish output, so an agent could reasonably pick either; the overlap is mitigated by pin_url being a lightweight URL builder, but the boundary is soft.

    Naming Consistency4/5

    Three of four tools follow a clear verb_noun pattern (get_pin, create_pin, search_pins). pin_url deviates as a bare noun phrase and would be more consistent as get_pin_url, but the set is still highly readable.

    Tool Count4/5

    Four tools is a tight, well-scoped surface for a pin map service: read one, write one, search, and build a share link. Slightly lean, but nothing feels gratuitous or missing at the count level.

    Completeness3/5

    Create, read, and search are covered, but there is no update_pin or delete_pin, so users cannot edit or remove a pin once posted, and there is no way to check a paid pin's payment/status after checkout. These are notable lifecycle gaps for a user-generated content service.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables location-aware AI agents to search for nearby places, get detailed place information including hours and ratings, and calculate routes with turn-by-turn directions using Google Maps APIs.
      22
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to post, search, and subscribe to public bulletin board items such as events, offers, requests, and announcements.
      121 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to find nearby public places such as pharmacies, supermarkets, gas stations, EV chargers, libraries, and post offices, with attributed opening-hours data from OpenStreetMap.
      1
      MIT