app.pindropped/pindropped
OfficialAn MCP server for finding, viewing, sharing, and posting PinDropped neighborhood map pins.
Search live pins near a latitude/longitude within a radius, or inside a bounding box, with optional category filtering and result limits.
Retrieve a single pin by ID to see its full details.
Generate a public shareable page URL for a pin.
Create public pins only after explicit user confirmation, with location, title, details, category, optional link, and free, daily, or monthly/permanent plans; paid plans return a Stripe checkout URL.
Enables paid PinDropped pin plans through Stripe checkout: paid pin creation returns a Stripe checkout_url so the user can complete payment before the pin goes live.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@app.pindropped/pindropped Find lost pet pins near 38.889, -77.004 within 2 miles."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pindropped-mcp
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):
https://pindropped.app/llms.txt: the short summary for LLMshttps://pindropped.app/agents: the full guide for AI agents (also as Markdown at/agents.md)https://pindropped.app/openapi.jsonand interactive API docs
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 |
| Live pins near | read-only |
| One pin by id | read-only |
|
| none |
| Posts a public pin. Needs | 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 |
| $0 | 12 hours (3 free pins per day per IP address) |
| $1/day, | N days |
| $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/mcpClaude 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-mcpAny other MCP client
stdio: command
uvx, args["--from", "git+https://github.com/pindropped/pindropped-mcp", "pindropped-mcp"]. If you installed with pip, use the commandpindropped-mcpinstead.HTTP: run
pindropped-mcp --httpand point the client athttp://127.0.0.1:8000/mcp.The env var
PINDROPPED_BASE_URLoverrides 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 testsThe create tests use respx mocks, so they never post to the real site.
MIT licensed.
Available Tools
4 toolscreate_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_pinARead-only
Get one PinDropped pin by its id (e.g. '2f2187f85a7c'). Returns full details plus its share url.
Inputs: id (required). Returns: object
pin_urlBRead-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_pinsARead-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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Spatial coordination for AI agents: read nearby activity or post intents; publishing is paid.
Spatial coordination for AI agents: read nearby activity or post intents; publishing is paid.
Bulletin board for agents: find and post local events, offers and requests. Reads need no key.
Search products in nearby stores. Agents can also list items for sale on a user's behalf.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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.22MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to post, search, and subscribe to public bulletin board items such as events, offers, requests, and announcements.121 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to browse boards, search pins, scrape images from URLs, and create, update, or pin visual bookmarks directly into a self-hosted instance.8MIT