---
title: "Calypso API: OpenAI-compatible endpoint, MCP, n8n & Web Widget | Calypso"
canonical_url: "https://www.calypso.so/integrations/api"
last_updated: "2026-09-11T03:04:46.587Z"
meta:
  description: "Everything under Calypso is an API. Call the same Calypso Agent through an OpenAI-compatible API, MCP clients, n8n workflows, upload pipelines, and an embeddable web widget."
  keywords: "Calypso API, Calypso API, RAG integrations, MCP RAG, n8n RAG, OpenAI compatible RAG API, AI answer widget, RAG upload API"
  "og:description": "Everything under Calypso is an API. Call the same Calypso Agent through an OpenAI-compatible API, MCP clients, n8n workflows, upload pipelines, and an embeddable web widget."
  "og:title": "Calypso API: OpenAI-compatible endpoint, MCP, n8n & Web Widget | Calypso"
  "twitter:description": "Everything under Calypso is an API. Call the same Calypso Agent through an OpenAI-compatible API, MCP clients, n8n workflows, upload pipelines, and an embeddable web widget."
  "twitter:title": "Calypso API: OpenAI-compatible endpoint, MCP, n8n & Web Widget | Calypso"
---

Calypso home

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.

[**Get an API key **](https://whatsapp.calypso.so/join) [**Read docs **](https://docs.calypso.so/)

WebsiteAPIMCPWorkflows

**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 **

**API****MCP****n8n****Widget****Product 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.

[**Get an API key **](https://whatsapp.calypso.so/join) [**Meet the Agent **](https://www.calypso.so/calypso-agent)