Calypso for developers

Built for people.Open todevelopers.

Every Calypso capability is available by API — an OpenAI-compatible endpoint, MCP clients, n8n workflows, upload pipelines, and product UI, with citations everywhere.

Website API MCP Workflows

Integration flow

Upload → Bucket → Agent → Answer

Live

Source event

new_ticket_policy.pdf

routed to support-handbook

Webhook

ingest

Agent

answer

Sources

cited

Answer surfaces

APIMCPn8nWidgetProduct UI

Website

Embed source-backed answers

Launch a polished answer widget that searches selected Buckets and shows citations on your site.

API

Call Calypso like a model

Use OpenAI-compatible requests grounded in your business knowledge, with source metadata.

MCP

Connect AI clients to knowledge

Let MCP-aware tools upload files, inspect Buckets, and call source-grounded agents.

n8n

Bring Calypso into workflows

Route tickets, forms, documents, and events through Calypso inside automations.

API workflow

One call pattern, every grounded answer surface.

Use the same Responses-style request from your backend, workflows, product UI, or AI tools. Calypso handles retrieval, policy, and source-backed output. In the API, Calypso Context is buckets and sources; the Calypso Agent is the calypso-rag-agent model family — the same nouns the docs use.

Responses API

Ask from any backend

Python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["CALYPSO_API_KEY"],
    base_url="https://api.calypso.so/v1",
)

response = client.responses.create(
    model="calypso-rag-agent:support",
    input="Summarize the refund policy for this ticket.",
    reasoning={"effort": "low"},
)

print(response.output_text)
01

Route sources

Send files, websites, Q&A, and batch jobs into the right Buckets.

02

Wait for readiness

Use bucket-active sources before agents answer from new knowledge.

03

Call Calypso

Ask the same Calypso from API, MCP, widget, workflow, or UI.

04

Return evidence

Send grounded answers with source references, citations, and metadata.

Answer surfaces

Use the same agent where work happens.

Connect one Bucket-backed agent to customer support, internal operations, sales enablement, product help, AI clients, and workflow automations.

Website widget

Drop grounded answers onto marketing, docs, or support pages.

OpenAI-compatible API

Use hosted agents through familiar request patterns.

MCP clients

Let agent tools upload files and use bucket-backed context.

n8n workflows

Answer from policies, tickets, PDFs, and internal docs in automations.

Batch upload jobs

Prepare up to 100 files with shared or per-item bucket routing.

Product UI

Embed source-grounded answers in your own customer experience.

Build with Calypso

Ship the Calypso Agent inside your stack.

Load knowledge into Context, put the Calypso Agent to work, and expose grounded answers through your website, backend, MCP clients, n8n workflows, and product experience.