GunSpec
Atlas

Atlas

Atlas is how to build with GunSpec: practice guides that span several endpoints, plus account help and troubleshooting.

Core practice

The five things every integration gets right or pays for: resolving names, holding a copy, failing well, staying inside the plan, and where the key lives.

Resolve before you readTurn a name somebody typed into a catalog id, and know when the answer is not certain enough to use.Mirror the catalogBackfill once, take deltas from webhooks, revalidate for free, and sweep for what was missed.Handle failureWhich errors are worth retrying, which can only fail again, and what the reader sees meanwhile.Stay inside the planWhich calls are free, which request shape replaces five, and the signals that mean upgrade rather than optimise.Keys in productionWhere a key may live, the proxy that keeps it off the browser, and how to rotate one without an outage.

Build recipes

One page per thing people ship. Each is the call order, the sample, and the mistakes the first version makes.

Build a product pageOne firearm page end to end: resolve, record, media, sellers, and what to show when a field is missing.Find the right recordsWhich call answers which question: filters, facets, full-text search, autocomplete, variants and lookalikes.Render the artworkSilhouettes, cartridge drawings, photographs and 3D models: URL, raw bytes or data URI, and when each one is right.What fits whatAttachment compatibility computed from mount interfaces: the call order, what a confidence score means, the gates nothing bridges.Cartridges and ballisticsCartridge, factory load, firearm plus load, and published figures: four questions people ask as one.Build a marketplaceSpecification-backed listings, counted outbound links, and the seller feed that pushes prices and stock back.Game stats without driftPin a snapshot for a build, read live for a website, and know which of the two you are on.

SDKs and agents

Writing the client code, in TypeScript and Python, and building on the hosted MCP server.

SDK patternsOne client, retries, conditional requests, auto-paging, typed errors and raw bytes, in TypeScript and Python.Build an agentWhich MCP tools to chain for a job, the rules that keep answers honest, and what an agent costs per conversation.

Answers

Questions with short answers: how the platform behaves, and what the licence allows.

Platform answersShort answers on sandboxes, CORS, timestamps, health checks, catalog size and bulk export.What you may do with the dataReselling, attribution, mirroring, images and accuracy, summarised from the Terms with links to them.

Help and account

Where to go for a key, a fix, or an answer that is not in the guides.

Account managementManage your API keys, plan, and billing.TutorialsStep-by-step guides and walkthroughs on the blog.FAQAnswers to the questions developers ask most.

We are still charting Atlas. Missing something you need? Tell us and we will add it.