Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"swarm-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# swarm-mcp An MCP server over a Foursquare Swarm check-in history, back to the first check-in. ## Status Shipped and maintained. First released December 18, 2025, ten months before Foursquare shipped its own Swarm MCP in October 2026. Re-verified against the live Foursquare API on October 27, 2026: all 11 tools pass. ## License MIT ## History | Date | Release | What changed | |------|---------|--------------| | 2025-12-18 | [0.1.0](https://pypi.org/project/swarm-mcp/0.1.0/) | First public release on GitHub and PyPI: check-in history, date ranges, recent check-ins, stats, search | | 2025-12-22 | [0.2.0](https://pypi.org/project/swarm-mcp/0.2.0/) | `_meta` transparency block and per-tool cost signals | | 2025-12-22 | [0.3.0](https://pypi.org/project/swarm-mcp/0.3.0/) | Category, city, and date filters on search | | 2025-12-22 | [0.4.0](https://pypi.org/project/swarm-mcp/0.4.0/) | `get_categories` with parent-category matching | | 2025-12-23 | [0.5.0](https://pypi.org/project/swarm-mcp/0.5.0/) | Venue details, top venues, state and country filters | | 2026-10-07 | [0.5.1](https://pypi.org/project/swarm-mcp/0.5.1/) | Pinned `mcp<2` after MCP Python SDK 2.0 removed the server API it used | | 2026-10-27 | 0.6.0 | Ported to MCP Python SDK 2.x; tool errors now set `isError` | The [commit history](https://github.com/alexpriest/swarm-mcp/commits/main) and [PyPI release history](https://pypi.org/project/swarm-mcp/#history) are the public record. ## Features | Tool | Description | |------|-------------| | `get_checkins` | Get paginated check-in history | | `get_checkins_by_date_range` | Get check-ins within a specific date range | | `get_recent_checkins` | Get check-ins from the past X days | | `get_checkin_details` | Get details about a specific check-in | | `get_venue_details` | Get venue info: ratings, hours, tips, photos | | `get_all_checkins` | Retrieve your entire check-in history | | `get_checkin_stats` | Get statistics (total count, date range, averages) | |…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.