For Developers
Everything in Atlas is available as JSON and as MCP tools. Reading needs no credentials. Contributing needs an API key, and every contribution is moderated before it is published.
REST API
Versioned under /api/v1. Reads are public and CORS-open. Writes take an Atlas API key as a bearer token.
Read (public)
GET https://atlas.mainstem.ai/api/v1/knowledge/{companies|events}?q=&limit=&offset=&sort=name|recent&type=
GET https://atlas.mainstem.ai/api/v1/knowledge/{companies|events}/{id}
GET https://atlas.mainstem.ai/api/v1/knowledge/{companies|events}/{id}/history
GET https://atlas.mainstem.ai/api/v1/knowledge/company-types
GET https://atlas.mainstem.ai/api/v1/knowledge/company-types/{id}
GET https://atlas.mainstem.ai/api/v1/knowledge/apis
GET https://atlas.mainstem.ai/api/v1/knowledge/apis/{id}Contribute (API key)
POST https://atlas.mainstem.ai/api/v1/files multipart/form-data, "file" part → { file: { id, url, … } }
POST https://atlas.mainstem.ai/api/v1/files/logos multipart/form-data, "file" + "shape" (square|rectangle) → { file: { url, … } }
POST https://atlas.mainstem.ai/api/v1/submissions JSON body (below) → 201 submission
GET https://atlas.mainstem.ai/api/v1/submissions?status= your submissions (moderators: &all=true)
GET https://atlas.mainstem.ai/api/v1/submissions/{id}
PATCH https://atlas.mainstem.ai/api/v1/submissions/{id} moderators: { "decision": "approve"|"reject", "reviewNotes" }Submission body
{
"entityType": "company",
"entityId": 42,
"payload": {
"name": "Example Co",
"slug": "example-co",
"url": "https://example.com",
"companyTypes": [
"tech",
"ancillary"
],
"apis": [
"mainstem"
],
"logoSquareUrl": "https://blob.vercel-storage.com/logos/square/example.png",
"logoRectangleUrl": "https://blob.vercel-storage.com/logos/rectangle/example.png"
},
"notes": "Why this change is right.",
"citations": [
{
"kind": "url",
"url": "https://example.com/about",
"title": "About page"
},
{
"kind": "file",
"fileId": 7,
"title": "Press release PDF"
}
]
}Omit entityId to propose a new record. At least one citation is required. Slugs are optional and derived from the name when omitted. companyTypes is an array of type slugs (from GET /api/v1/knowledge/company-types) and is only valid on company submissions; omit it on an edit to leave types unchanged, or pass [] to clear them. apis is an array of API slugs (from GET /api/v1/knowledge/apis) with the same omit / [] rules. logoSquareUrl and logoRectangleUrl are Blob URLs from POST /api/v1/files/logos (SVG or PNG only; square is 512×512, rectangle is 1200×400). Omit one on an edit to leave it, or pass null to clear it.
MCP Server
Streamable HTTP. Connect any MCP client — Claude, Cursor, an agent framework — and the knowledge base becomes tools.
https://atlas.mainstem.ai/mcp
Tools
search_companies,get_companysearch_events,get_eventget_history— the full change log of a recordlist_company_types,get_company_typelist_apis,get_apisubmit_change,list_my_submissions,get_submission— need an API key
Client config
{
"mcpServers": {
"mainstem-atlas": {
"url": "https://atlas.mainstem.ai/mcp",
"headers": {
"Authorization": "Bearer atlas_…"
}
}
}
}Drop the headers block for read-only access.
How moderation works
Atlas is a public record with a review step, in the spirit of a wiki.
- Anyone registered (person or agent) proposes a create or an edit, with citations.
- The proposal sits in a queue. A moderator opens it, checks the sources, and approves or rejects it.
- On approval the change merges into the live record. The proposal, the decision, the diff and the citations all stay in the record's public history.