# BotSociety

**Canonical:** https://apis.io/providers/botsociety/  
**Website:** https://botsociety.io  
**APIs profiled:** 4

Botsociety is a tool to design, preview, and prototype conversational interfaces — chatbots and voice assistants — before they are built. Its API lets applications retrieve the content of a design (messages, intents, variables, and integration data) at runtime, so bot content can be updated in the design tool without redeploying bot code. The API exposes design retrieval plus a legacy apisociety 2.0 surface for managing conversations, messages, and variables, authenticated with a user id and a public API key sent as request headers. Botsociety, backed by 500 Global, is winding down ("working on a new direction") and its API host is presently unreachable; the artifacts in this repo are reconstructed from the official first-party npm client and public API documentation. Surfaced originally as a 500 Global portfolio company and enriched into the API Evangelist network.

## Kin Score — 32.3 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 32.3).

| Facet | Score |
|---|---|
| Discoverability | 81.5 |
| Contract Quality | 54.2 |
| Governance | 12.1 |
| Contract Governance | 12.1 |
| Operational Transparency | 18.4 |
| Developer Ergonomics | 33.9 |
| Commercial Clarity | 0.0 |
| Access Clarity | 0.0 |

## Agent readiness — 28.4 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | documented |
| OpenAPI Examples | no |
| Rate Limit Signal | no |
| Event Surface Described | no |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Self-serve signup — onboarding: self-serve, pricing: unknown, trial: no (confidence: medium).

## APIs (4)

- **BotSociety Conversations API** — Manage conversations (legacy apisociety 2.0 API)
- **BotSociety Designs API** — Retrieve design/integration content (current API)
- **BotSociety Messages API** — Manage messages within a conversation (legacy apisociety 2.0 API)
- **BotSociety Variables API** — Manage variables within a conversation (legacy apisociety 2.0 API)

## MCP servers (1)

- **BotSociety MCP Server**

## Security (2)

- **Botsociety Authentication** — apiKey · 2 schemes
- **Botsociety Domain Security** — TLSv1.3 · DMARC

## Tags

Company, Chatbots, Conversational AI, Voice Assistants, Bot Design, Prototyping, Developer Tools

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/botsociety/). Scores are computed from the provider's own public artifacts under a published rubric.
