# Spatibase docs

> Set up a map project, publish its places through the Content Delivery API, connect AI assistants through MCP and keep the content up to date.

## Get started

- [What is Spatibase?](https://spatibase.com/docs/get-started/what-is-spatibase.md): A headless CMS for map projects: model your places, keep them up to date with your team and publish them as an API for your maps and apps.
- [Create a project](https://spatibase.com/docs/get-started/create-a-project.md): Sign in, then start with your coding agent, from your own data (a file, a Google Sheet, a Google My Maps map or a PostGIS table), from a template or blank.
- [Find your way around](https://spatibase.com/docs/get-started/find-your-way-around.md): Tour the sections of a project, the side panel and the Getting started checklist, and jump anywhere with search, shortcuts and dark mode.
- [Your first map in ten minutes](https://spatibase.com/docs/get-started/first-map.md): Create a project, add a few places on the map, give them the fields you need, publish them and see the API result, all without code in about ten minutes.

## Model your data

- [Types](https://spatibase.com/docs/model/types.md): Create a type such as Store, Trail or Event, choose its location rule, shapes and color, add subtypes, and turn a type off or delete it safely.
- [Elements](https://spatibase.com/docs/model/elements.md): Add text, number, choice, image and other elements to a type, pick the right kind for each detail, and reuse one element across several types.
- [Map feature types](https://spatibase.com/docs/model/map-feature-types.md): Name and style the extra shapes on an entry, such as Trail lines or Parking areas, and connect them to a Map shapes element so editors can draw them.
- [Change the model safely](https://spatibase.com/docs/model/change-the-model.md): See what renaming, removing or reassigning types and elements does to existing entries and to the sites that read them, with tips for safe modelling.

## Add content

- [Add an entry on the map](https://spatibase.com/docs/content/entries.md): Create an entry from a type, place it on the map by clicking or searching an address, fill in its fields and save it as a draft to mark ready later.
- [Edit entries in a table](https://spatibase.com/docs/content/table.md): Change many entries at once in spreadsheet-style cells on a computer, with copy and paste, fill down, undo and the keyboard keys you know.
- [Collect entries on a phone](https://spatibase.com/docs/content/collect.md): Open Collect in your phone browser, add it to the Home Screen, then add entries, set locations from GPS and attach photos while you are out in the field.
- [Import your data](https://spatibase.com/docs/content/import.md): Turn a file, a Google Sheet, a My Maps map or a PostGIS table into entries, match columns to fields and update the entries you already have.
- [Find, edit and export entries](https://spatibase.com/docs/content/find-edit-export.md): Filter entries by status, type and more, change many at once, mark them ready and publish, review AI assistant changes and export all entries as GeoJSON.
- [Use the media library](https://spatibase.com/docs/content/media.md): Upload images, PDFs and other files once in Media, find and rename them, add alt text and reuse them in as many entries as you like.
- [Curate groups of entries](https://spatibase.com/docs/content/groups.md): Build a hand-picked, ordered list of entries such as Featured on homepage, reorder it, and let your website load it by identifier in your chosen order.
- [Translate your content](https://spatibase.com/docs/content/translations.md): Offer entries in more than one language, translate them with the language pills, find what is missing and let an AI assistant do the typing.
- [Change the map style](https://spatibase.com/docs/content/map-style.md): Switch the editor basemap, hide labels, try the blueprint look or add your own style, and set the dashboard thumbnail. Your website or app is unaffected.

## Publish

- [Drafts and publishing](https://spatibase.com/docs/publish/draft-and-published.md): Saving keeps work as a draft; marking it ready and pressing Publish puts it live in the Delivery API as a numbered version. Unpublish and delete too.
- [Versions and going back](https://spatibase.com/docs/publish/versions.md): Every publish is saved as a numbered version of everything that is live. See what changed in each, and go back to any kept version in one click.
- [Preview your data](https://spatibase.com/docs/publish/preview-data.md): Open a ready-made map page of your published entries to check what your API serves, find an entry, show or hide types and share a link to a view.
- [Access and API keys](https://spatibase.com/docs/publish/access-and-keys.md): Copy your project's API address with Copy API address, decide whether it is public or private, then create, replace and revoke API keys and assistant keys.
- [Webhooks](https://spatibase.com/docs/publish/webhooks.md): Set up a webhook so your server is called whenever published content changes, send a test message and pause, change or remove the address.

## Build with the API

- [Concepts for developers](https://spatibase.com/docs/build/concepts.md): Understand how projects, elements, types, entries, groups and drafts fit together, and how the read-only Content Delivery API serves only published content.
- [Quickstart: a map in ten minutes](https://spatibase.com/docs/build/quickstart.md): Go from an empty project to published entries on a MapLibre GL map, a Leaflet map and a vector-tile layer, with copy-ready curl and JavaScript.
- [Start from your code](https://spatibase.com/docs/build/start-from-your-code.md): Paste one prompt into your coding agent and move the places hard-coded in your app into a Spatibase project, with or without an account.
- [The spatibase command](https://spatibase.com/docs/build/cli.md): Create a project, import places from a file and publish them from the terminal with the spatibase command, with its options and exit codes.
- [Recipes](https://spatibase.com/docs/build/recipes.md): Copy ready-made Delivery API calls for a store locator, a delivery area check, field filters, colors per type, ordered groups and ETag caching.
- [Build an app with your content and a coding agent](https://spatibase.com/docs/build/build-with-a-coding-agent.md): Give Claude Code or Codex your project's facts, then let it build a map or a site that reads your published content from the API.

## Team and account

- [Members and roles](https://spatibase.com/docs/team/members-and-roles.md): See what Owners, Editors and Developers can each do, then invite people to a project, change their role, remove them or leave a project yourself.
- [Activity and trash](https://spatibase.com/docs/team/activity-and-trash.md): Read the Activity log of who changed what, review what AI assistants changed, and restore deleted entries and files from the Trash within 30 days.
- [Account and plan](https://spatibase.com/docs/team/account-and-plan.md): Sign in with an emailed link or code, change account settings, compare plans, delete your account or change your email.

## AI assistants

- [Connect an AI assistant](https://spatibase.com/docs/ai/connect-an-assistant.md): Copy your project's assistant address and add it to Claude.ai, Claude Desktop, ChatGPT, Claude Code or Cursor, with your account or an assistant key.
- [What AI assistants can do](https://spatibase.com/docs/ai/what-assistants-can-do.md): See what Claude or ChatGPT can do in a project by role and key, from reading and drafting to publishing and deleting, and how you stay in control.
- [MCP server reference](https://spatibase.com/docs/ai/mcp-server.md): Connect an agent to a project's MCP endpoint at mcp.spatibase.com, see which credential unlocks which tools and learn about dry runs, errors and limits.
- [OAuth for MCP clients](https://spatibase.com/docs/ai/oauth.md): Connect Claude.ai, ChatGPT or another MCP client with OAuth 2.1 and PKCE, with the endpoints, client registration, consent screen and revoking access.

## API reference

- [Content Delivery API reference](https://spatibase.com/docs/reference/delivery-api.md): Look up the read-only Content Delivery API endpoints, query parameters, filters, errors, caching and responses for types, entries, groups and map feature types.
- [Field values](https://spatibase.com/docs/reference/field-values.md): Look up the JSON each of the 17 element kinds returns in Delivery API output, how empty values appear and which filter operators work per kind.
- [GeoJSON and vector tiles](https://spatibase.com/docs/reference/geojson-and-tiles.md): Pick between paged entries.geojson and Mapbox vector tiles with TileJSON, filter tiles, handle caching and private projects, and use MapLibre GL JS.
- [Assets and images](https://spatibase.com/docs/reference/assets-and-images.md): Use permanent asset URLs cached for a year, and resize or convert images on request with w, h, fit, fmt and q for responsive images in your app.
- [Authentication](https://spatibase.com/docs/reference/authentication.md): Choose between a sign-in session, a Content Delivery API key and an AI assistant edit key, and see how each is sent and which requests it allows.
- [Webhook events](https://spatibase.com/docs/reference/webhook-events.md): See the five events a signed webhook POST can send, how to verify the signature, how retries work and the address rules your receiving endpoint must meet.
- [Import API](https://spatibase.com/docs/reference/import-api.md): POST GeoJSON features or CSV and TSV rows into one type as drafts, with location rules, value conversion, matchBy updates, geocoding and result warnings.
- [Content Management API](https://spatibase.com/docs/reference/management-api.md): Script setup and data loading with the JSON API behind the web app, covering session sign-in, errors, and the endpoints for types, entries and groups.
- [Limits](https://spatibase.com/docs/reference/limits.md): Check what Spatibase supports and what it does not, plus the numbers to design around, from Delivery API paging and image limits to uploads and webhooks.

## Help

- [Frequently asked questions](https://spatibase.com/docs/help/faq.md): Quick answers about sign-in, the content model, publishing, the API, AI assistants, Collect and plans, each linking to the page with the full story.
- [Glossary](https://spatibase.com/docs/help/glossary.md): Look up any Spatibase term, from entry, element and type to draft, group and API key, in one or two plain sentences with a link to the full page.
