[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_123":124},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":47,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":47,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":47,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":-5,"_79":-5,"_80":-5,"_81":47,"_82":-5,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96},"apiUrl","https://odel.app/api","creator","bobymicjohn","moduleId","2b2tatlas-public-api","@bobymicjohn/2b2tatlas-public-api","displayName","2b2t Atlas","tagline","Search 2b2t locations, groups, highways, renders, Archive warps, and WDL metadata.","iconKey","https://avatars.githubusercontent.com/u/7483240?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://api.blackportal.cloud/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1788669388000,"updatedAt","sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.bobymicjohn%2F2b2t-atlas","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1788668847000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/bobymicjohn/2b2tAtlas-Public-API","githubRepoFullName","bobymicjohn/2b2tAtlas-Public-API","releaseId","ext-bobymicjohn-2b2tatlas-public-api","version","1.0.0","descriptionMarkdown","# 2b2tAtlas Public API\n\n[![API status](https://img.shields.io/website?url=https%3A%2F%2Fapi.blackportal.cloud%2Fapi&label=public%20API)](https://api.blackportal.cloud/api)\n[![OpenAPI](https://img.shields.io/badge/OpenAPI-live-6BA539)](https://api.blackportal.cloud/openapi/v1.json)\n[![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-8b5cf6)](https://2b2tatlas.com/mcp/)\n[![Official MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.bobymicjohn%2F2b2t--atlas-5b5fc7)](https://registry.modelcontextprotocol.io/?q=io.github.bobymicjohn%2F2b2t-atlas)\n[![Data provided by 2b2tAtlas](https://img.shields.io/badge/data-2b2tAtlas-b45309)](https://2b2tatlas.com)\n[![License: Unlicense](https://img.shields.io/badge/license-Unlicense-blue.svg)](LICENSE)\n\nBuild Minecraft mods, map overlays, Discord bots, history tools, waypoint exporters, and research projects with the public [2b2tAtlas](https://2b2tatlas.com) data API.\n\nThis is a documentation and examples repository. It does **not** contain the private Atlas application, collector, credentials, moderation tools, or server infrastructure.\n\n## Start here\n\n- API base: [`https://api.blackportal.cloud`](https://api.blackportal.cloud/api)\n- Interactive Atlas: [`https://2b2tatlas.com`](https://2b2tatlas.com)\n- Live OpenAPI contract: [`/openapi/v1.json`](https://api.blackportal.cloud/openapi/v1.json)\n- MCP endpoint: [`https://api.blackportal.cloud/mcp`](https://2b2tatlas.com/mcp/)\n- Official MCP Registry name: [`io.github.bobymicjohn/2b2t-atlas`](https://registry.modelcontextprotocol.io/?q=io.github.bobymicjohn%2F2b2t-atlas)\n- Authentication: none for the public `GET` routes documented here\n- Format: JSON over HTTPS; public reads allow browser CORS\n\n```csharp\n// Find a location\nvar locations = await http.GetFromJsonAsync>(\"api/locations\");\nvar mu = locations!.First(x => x.Name.Equals(\"Mu Megabase\", StringComparison.OrdinalIgnoreCase));\n\n// Find bases by group\nvar groups = await http.GetFromJsonAsync>(\"api/groups\");\nvar group = groups!.First(x => x.Name.Contains(\"DonFuer\", StringComparison.OrdinalIgnoreCase));\nvar groupWithBuilds = await http.GetFromJsonAsync($\"api/groups/{group.Id}\");\n\n// Query Archive warps for a location\nvar warps = await http.GetFromJsonAsync>($\"api/warps?locationId={mu.Rowid}&limit=100\");\n\n// Follow an eligible warp's worldDownloadMetadataUrl or worldDownloadUrl.\n// These are bounded historical Java saves, not complete copies of 2b2t.\n\n// Find locations with WDL-derived map renders\nvar renders = await http.GetFromJsonAsync>(\"api/renders?limit=1000\");\nvar renderedLocationIds = renders!.Select(x => x.LocationId).Distinct().ToHashSet();\n\n// Query public, reviewed highways and canals\nvar highways = await http.GetFromJsonAsync>(\"api/highways\");\n```\n\nThe complete, runnable version is in [`examples/csharp`](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/examples/csharp). Dependency-free [JavaScript](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/examples/javascript), [Python](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/examples/python), and a [Fabric-oriented Java pattern](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/examples/fabric) are included too.\n\n## Connect an AI assistant with MCP\n\n2b2tAtlas exposes a public, stateless, read-only Model Context Protocol server. MCP clients can search and traverse the Atlas knowledge graph without downloading the entire catalog or teaching a model every REST relationship.\n\n```json\n{\n \"mcpServers\": {\n \"2b2t-atlas\": {\n \"type\": \"http\",\n \"url\": \"https://api.blackportal.cloud/mcp\"\n }\n }\n}\n```\n\nThe server offers 15 bounded tools for locations, nearby and historical searches, groups and their builds, highways, Archive warps, render provenance, WDL metadata, preserved builds, and dataset statistics. It also exposes stable resources such as `2b2tatlas://location/{id}`. See the complete [MCP client and tool guide](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/docs/MCP.md).\n\nThe canonical discovery record is published as [`io.github.bobymicjohn/2b2t-atlas`](https://registry.modelcontextprotocol.io/?q=io.github.bobymicjohn%2F2b2t-atlas) in the official MCP Registry. Its checked-in [`server.json`](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/server.json) and [OIDC publishing workflow](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/.github/workflows/publish-mcp-registry.yml) make the remote endpoint independently discoverable and every registry release reproducible.\n\nMCP is an agent interface over the same reviewed Atlas records, not a second AI-generated database. It returns metadata and public HTTPS links rather than putting WDL ZIPs or render images into model context.\n\nAll runnable examples default to production. Set `ATLAS_API_BASE_URL` to point them at a mock or development server; the repository's CI uses this seam to test every example without generating bursts against the public service.\n\n## What can I build?\n\n| Project idea | Atlas data to use |\n| --- | --- |\n| JourneyMap/Xaero-style landmark layer | locations, dimensions, coordinates, canonical URLs |\n| Historical base time machine | render footprints, dates, day/night tile templates |\n| Highway and canal route planner | reviewed geometry, dimensions, widths, builder groups |\n| Nether portal travel helper | Overworld/Nether coordinates plus local 8:1 conversion |\n| `/whereis`, `/history`, or `/group` Discord bot | locations, warps, groups, builds, source links |\n| Archive warp resolver | exact Archive warp identities and owning locations |\n| Group lineage/build explorer | reciprocal group-to-build and group-to-highway records |\n| Offline nearest-landmark search | cache `/api/locations` and build a local spatial index |\n| WDL coverage dashboard | locations with renders, render dates, footprints, warp provenance |\n| Offline archaeology / block analysis | immutable bounded-world ZIP, SHA-256, chunk count, exact bounds |\n| LLM/RAG history corpus | static JSONL entity feeds, canonical pages, cited media records |\n| MCP research assistant | bounded semantic tools, canonical resource URIs, reciprocal entity relationships |\n| World-download browser or mirroring tool | WDL JSONL catalog, resumable ZIP links, checksums, scope warnings |\n\nSee [2b2t-specific project ideas](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/docs/2B2T-IDEAS.md) for more—including safe client-thread patterns, route overlays, pilgrimage lists, historical diffing, and source-aware research tools.\n\n## Projects using 2b2tAtlas\n\n- [XaeroTools](https://github.com/dekrom/xaerotools) is an open-source browser, merger, backup, and live-sharing toolkit for Xaero's World Map and XaeroPlus data. Its optional 2b2tAtlas overlay loads community-documented locations with Atlas source links, and it can mirror Atlas map imagery for local use.\n\nBuilt something with the API? Open an [integration showcase](https://github.com/bobymicjohn/2b2tAtlas-Public-API/issues/new?template=integration-showcase.yml) so other players and tool authors can find it.\n\n## Public endpoints\n\n| Resource | Routes | Useful relationships |\n| --- | --- | --- |\n| Locations | `GET /api/locations`, `GET /api/locations/{id}` | warps, attachments, renders, builder groups |\n| Archive warps | `GET /api/warps`, `GET /api/warps/{id}` | owning location, WDL date/SHA and bounded-world links when available |\n| Archive world ZIPs | `GET /api/warps/{id}/world-download`, `GET /api/warps/{id}/world-download.zip` | size, digest, bounds, resumable immutable Java-save download |\n| WDL renders | `GET /api/renders`, `GET /api/renders/{id}`, `GET /api/locations/{id}/renders` | location, Archive warp or preserved source, tile template, footprint |\n| Legacy render-source ZIPs | `GET /api/renders/{id}/world-download`, `GET /api/renders/{id}/world-download.zip` | verified pre-Archive/community source, digest, provenance, resumable download |\n| Historical media | `GET /api/attachments`, `GET /api/attachments/{id}` | location, source, caption, attribution |\n| Groups | `GET /api/groups`, `GET /api/groups/{id}` | aliases, attributed builds and highways |\n| Highways | `GET /api/highways`, `GET /api/highways/{id}` | geometry and reviewed group roles |\n| Map layers | `GET /api/maprenders`, `GET /api/maprenders/catalog` | primary layers plus per-location renders |\n\nThe [API reference](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/docs/API-REFERENCE.md) explains filters, paging, dimensions, stable links, errors, and caching. The live OpenAPI document is the machine-readable source of truth.\n\n## 2b2t-aware client guidance\n\n1. Fetch in a background thread. Never block Minecraft's render or client tick thread on HTTP.\n2. Cache responses. Location/group/highway reads are cacheable for at least 60 seconds; a mod should usually cache much longer or keep an offline snapshot.\n3. Follow `apiUrl`, `canonicalUrl`, `interactiveUrl`, `locationApiUrl`, and similar link fields instead of rebuilding URLs.\n4. Treat coordinates as historical public records—not proof that a base is active, intact, safe, or loaded on the live server.\n5. When practical, keep `sourceUrl`, `attribution`, and evidence fields with redistributed media or historical claims so their history remains traceable.\n6. Tolerate additive JSON fields. Public `GET` contracts are stable, but the catalog continues to grow.\n\n## Static and agent-friendly data\n\nFor crawlers, archives, bulk research, and language-model tools, 2b2tAtlas also publishes:\n\n- [`llms.txt`](https://2b2tatlas.com/llms.txt)\n- [`dataset.json`](https://2b2tatlas.com/dataset.json)\n- [`locations.jsonl`](https://2b2tatlas.com/entities/locations.jsonl)\n- [`groups.jsonl`](https://2b2tatlas.com/entities/groups.jsonl)\n- [`media.jsonl`](https://2b2tatlas.com/entities/media.jsonl)\n- [`world-downloads.jsonl`](https://2b2tatlas.com/entities/world-downloads.jsonl)\n- [crawlable world-download catalog](https://2b2tatlas.com/entities/world-downloads/)\n- [MCP server guide](https://2b2tatlas.com/mcp/) and remote endpoint at `https://api.blackportal.cloud/mcp`\n- [official MCP Registry record](https://registry.modelcontextprotocol.io/?q=io.github.bobymicjohn%2F2b2t-atlas) under `io.github.bobymicjohn/2b2t-atlas`\n- canonical HTML/JSON-LD pages under `/entities/locations/{id}/` and `/entities/groups/{id}/`\n\nUse the live API for interactive applications and the static feeds for deliberate bulk ingestion. The WDL feed identifies every available ZIP as a partial Java save and links it to its canonical location and render, plus its exact Archive warp when one exists. `sourceType` and `scope` distinguish collector-bounded snapshots from verified preserved sources behind older/community renders. See [LLM and bulk-data guidance](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/docs/2B2T-IDEAS.md#llm-search-and-research-tools).\n\n## Credit the data\n\nUse Atlas data however you want. No Atlas credit or permission is required. If Atlas data is visible or materially powers your project, this simple optional credit helps players find the historical source:\n\n```markdown\nData provided by [2b2tAtlas](https://2b2tatlas.com).\n```\n\nFor a mod About screen, README badge, website footer, or machine-readable notice, see [ATTRIBUTION.md](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/ATTRIBUTION.md). Original-source fields returned with attachments and evidence are kept so downstream projects can credit and verify them too.\n\n## Repository map\n\n```text\nexamples/\n csharp/ complete .NET console example\n fabric/ async Java/Fabric integration pattern\n javascript/ dependency-free Node example\n python/ dependency-free Python example\n requests.http copy-ready REST Client requests\ndocs/\n API-REFERENCE.md\n MCP.md\n COORDINATES-AND-RENDERS.md\n 2B2T-IDEAS.md\n```\n\n## Contributing and integrations\n\n- Open an [integration showcase](https://github.com/bobymicjohn/2b2tAtlas-Public-API/issues/new?template=integration-showcase.yml) when your tool uses the API.\n- Report unclear or stale documentation through the issue templates.\n- Add examples in another language or a small integration recipe through a pull request.\n- Ask for a new **public read** projection by describing the player/developer use case; never post credentials or non-public coordinates.\n\nRead [CONTRIBUTING.md](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/CONTRIBUTING.md) before submitting code. Questions and project demos are welcome in GitHub Discussions.\n\n## Stability and affiliation\n\nPublic read models may gain fields as the historical graph grows. Clients should ignore unknown JSON properties and use nullable handling for incomplete historical metadata. Write/admin endpoints are intentionally outside this repository.\n\n2b2tAtlas is a community historical project and is not affiliated with Mojang Studios, Microsoft, or the operators of 2b2t. Minecraft names and assets belong to their respective owners.\n\n## Design references\n\nThe repository's task-first examples and integration guidance borrow useful documentation patterns from [HypixelDev/PublicAPI](https://github.com/HypixelDev/PublicAPI), [GTNewHorizons/Navigator](https://github.com/GTNewHorizons/Navigator), and [odds-api/odds-api](https://github.com/odds-api/odds-api), adapted to the very different needs of a historical 2b2t map and entity graph.\n\n## License\n\nRepository-authored examples and documentation are released under the [Unlicense](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/LICENSE): copy, modify, publish, commercialize, or remix them for any purpose without permission or required attribution. Atlas likewise places no attribution condition on reuse of its factual API catalog; a link back is simply appreciated. Some records reference third-party media whose original source terms remain separate, as explained in [NOTICE.md](https://github.com/bobymicjohn/2b2tAtlas-Public-API/blob/main/NOTICE.md).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_111":112,"_113":114,"_115":116,"_117":118,"_119":120,"_121":122},"requiredSecrets",[],"tags",[99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_97":84,"_98":84},"ratingAvg","reviewCount","2b2t","2b2tatlas","api-examples","fabricmc","historical-data","map-api","minecraft","minecraft-api","minecraft-data","minecraft-mod","openapi","waypoints","topics",[99,100,101,102,103,104,105,106,107,108,109,110],"license","Unlicense","language","Python","registryName","io.github.bobymicjohn/2b2t-atlas","homepage","https://2b2tatlas.com/mcp/","packages",[],"ENV",{"_125":126,"_127":128,"_129":130},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]