--- title: "Cosmo by Humanizing Developer Resources — API, OpenAPI Spec, MCP Server" description: "Developer resources for Cosmo by Humanizing: the public REST API, its OpenAPI 3.1 spec, the Cosmo MCP server, llms.txt, and Markdown content negotiation for AI agents." url: "https://cosmo.humanizing.com/developers" language: "de" source: "text/html" --- > Developer resources for Cosmo by Humanizing: the public REST API, its OpenAPI 3.1 spec, the Cosmo MCP server, llms.txt, and Markdown content negotiation for AI agents. Developers # Cosmo by Humanizing developer resources Everything an engineer or an AI agent needs to read Cosmo product, pricing and company data programmatically: a public REST API, an OpenAPI 3.1 description, an MCP server, and Markdown versions of every page. ## Resource index All resources below are public, read-only and need no credentials. Base URL: `https://cosmo.humanizing.com`. - [OpenAPI 3.1 specification](https://cosmo.humanizing.com/openapi.json) `/openapi.json` — Every operation with a unique operationId, typed parameters and response schemas. - [Cosmo API reference](https://cosmo.humanizing.com/developers/api) `/developers/api` — Endpoints, query parameters, examples and the shared JSON error envelope. - [Cosmo MCP server](https://cosmo.humanizing.com/developers/mcp) `/developers/mcp` — Streamable HTTP endpoint that exposes the API as Model Context Protocol tools. - [MCP server manifest](https://cosmo.humanizing.com/.well-known/mcp.json) `/.well-known/mcp.json` — Machine-readable description of the MCP endpoint and its tools. - [llms.txt](https://cosmo.humanizing.com/llms.txt) `/llms.txt` — Condensed product guidance for large language models. - [Sitemap](https://cosmo.humanizing.com/sitemap.xml) `/sitemap.xml` — Every public URL on cosmo.humanizing.com. ## Cosmo public content API A read-only JSON API that returns the same product, pricing and company facts the marketing pages show, so agents do not have to scrape HTML. Five operations, all `GET`, all under `/api/v1`. ``` curl -s https://cosmo.humanizing.com/api/v1/products | jq curl -s "https://cosmo.humanizing.com/api/v1/pricing?interval=monthly" | jq curl -s https://cosmo.humanizing.com/api/v1/company | jq ``` Errors always use the same envelope, with a machine-readable `error.code` and an `error.resolution` that names the next step. The full reference is on the [Cosmo API reference](https://cosmo.humanizing.com/developers/api) page. ## Cosmo MCP server The Model Context Protocol server at `https://cosmo.humanizing.com/mcp` speaks JSON-RPC 2.0 over the Streamable HTTP transport and exposes 6 read-only tools: list\_cosmo\_products, get\_cosmo\_product, get\_cosmo\_pricing, get\_cosmo\_company\_profile, list\_cosmo\_pages, get\_cosmo\_page\_markdown. ``` claude mcp add --transport http cosmo https://cosmo.humanizing.com/mcp ``` Setup for other clients, the tool schemas and worked examples are on the [Cosmo MCP server](https://cosmo.humanizing.com/developers/mcp) page. ## Markdown content negotiation Every page of this site is available as Markdown from the same URL that serves HTML, following the `acceptmarkdown.com` convention. Ask for it with an `Accept` header, or append `.md` to any path. ``` curl -sH 'Accept: text/markdown' https://cosmo.humanizing.com/pricing curl -s https://cosmo.humanizing.com/pricing.md ``` Markdown responses carry `Content-Type: text/markdown; charset=utf-8` and `Vary: Accept, Accept-Encoding`, so a shared cache cannot hand the HTML variant to a client that asked for Markdown. A request that accepts neither HTML nor Markdown gets a `406 Not Acceptable` with a JSON body listing what is supported. ## 404s and error handling Unknown paths return a real HTTP `404`, never a 200 with an app shell. Clients that did not ask for HTML get a short Markdown body pointing at the sitemap, llms.txt and these developer resources, so an agent can recover without a second guess. ``` curl -s -o /dev/null -w '%{http_code}\n' https://cosmo.humanizing.com/no-such-page # 404 ``` ## Product documentation Setting up an agent, connecting channels and configuring knowledge is covered in the product documentation at [docs.cosmo.humanizing.com](https://docs.cosmo.humanizing.com). Questions about these interfaces: [contact@humanizing.com](mailto:contact@humanizing.com). [Back to homepage](https://cosmo.humanizing.com/) ### Produkte - [Voicebot](https://cosmo.humanizing.com/products/voicebot) - [Chatbot](https://cosmo.humanizing.com/products/chatbot) - [KI-Rezeption & Kiosk](https://cosmo.humanizing.com/products/reception-kiosk) - [Preise](https://cosmo.humanizing.com/pricing) ### Branchen - [Kommunen & Behörden](https://cosmo.humanizing.com/industries/public-sector) - [Hausverwaltungen](https://cosmo.humanizing.com/industries/property-management) - [Versicherungen](https://cosmo.humanizing.com/industries/insurances) - [Weitere Branchen](https://cosmo.humanizing.com/industries) - [Abfallkalenderbot](https://cosmo.humanizing.com/industries/public-sector/abfallkalenderbot) ### Ressourcen - [Anleitung](https://cosmo.humanizing.com/guide) - [Blog](https://cosmo.humanizing.com/blog) - [Dokumentation](https://cosmo.humanizing.com/developers) ### Unternehmen - [Über uns](https://cosmo.humanizing.com/about) - [Kontakt](https://cosmo.humanizing.com/contact) ### Rechtliches - [Datenschutzrichtlinie](https://cosmo.humanizing.com/privacy) - [Datenschutz der Cosmo Web App](https://cosmo.humanizing.com/web-app-privacy) - [Nutzungsbedingungen](https://cosmo.humanizing.com/terms) - [Cookie-Richtlinie](https://cosmo.humanizing.com/cookies) - [Impressum](https://cosmo.humanizing.com/impressum) - Cookie-Einstellungen [Cosmo by Humanizing](https://cosmo.humanizing.com/) © 2026 Humanizing Technologies GmbH. Alle Rechte vorbehalten. --- - [Homepage](https://cosmo.humanizing.com/) — Product overview - [Developer resources](https://cosmo.humanizing.com/developers) — API, OpenAPI spec, MCP server - [OpenAPI 3.1 spec](https://cosmo.humanizing.com/openapi.json) — Machine-readable REST description - [MCP server](https://cosmo.humanizing.com/mcp) — Streamable HTTP, JSON-RPC 2.0 - [llms.txt](https://cosmo.humanizing.com/llms.txt) — Condensed product guidance for LLMs - [Sitemap](https://cosmo.humanizing.com/sitemap.xml) — Every public URL