--- title: "Multimodal RAG API with citations | Calypso Context" canonical_url: "https://www.calypso.so/context" last_updated: "2026-09-16T00:41:14.359Z" meta: description: "Calypso Context is hosted multimodal RAG: load PDFs, images, web pages, and data into buckets and get cited answers through an OpenAI-compatible API, MCP, n8n, or a web widget. No vector database to run." keywords: "multimodal RAG, multimodal RAG API, hosted RAG, RAG with citations, OpenAI-compatible RAG API, chat with PDFs and images, Calypso Context" "og:description": "Calypso Context is hosted multimodal RAG: load PDFs, images, web pages, and data into buckets and get cited answers through an OpenAI-compatible API, MCP, n8n, or a web widget. No vector database to run." "og:title": "Multimodal RAG API with citations | Calypso Context" "twitter:description": "Calypso Context is hosted multimodal RAG: load PDFs, images, web pages, and data into buckets and get cited answers through an OpenAI-compatible API, MCP, n8n, or a web widget. No vector database to run." "twitter:title": "Multimodal RAG API with citations | Calypso Context" --- Calypso home **Calypso Context** # Multimodal RAG your users can check. Load PDFs, images, web pages, and data into buckets, and get cited answers through an OpenAI-compatible API, MCP, n8n, or a web widget. Hosted, so there is no vector database to run. [**Start 14-day free trial**](https://context.calypso.so/join) [**Read the developer docs**](https://docs.calypso.so/context) Calypso Context is the knowledge layer behind Calypso WhatsApp. Developers use it directly. **Live demo** Pick a corpus, ask, and read the citations. **Quick start** ## Point the OpenAI SDK at Calypso. That is the integration. Same client, same Responses call. The model is your agent; the answer comes back with the sources it drew on. 1. 01Create a project API key in Project → API Keys. 2. 02Put your sources in a bucket and wait for ready. 3. 03Call calypso-agent, or a named agent, from any OpenAI SDK. **CALYPSO_API_KEY** ``` 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-agent", input="What does the refund policy say about opened items?", ) print(response.output_text) # Sources arrive as file_search_call.results[] with source_index, # label, page_number, and access_url. ``` **What it reads** ## PDFs, images, pages, and data. Read, not just stored. A source is accepted if Calypso can actually read it, and rejected at upload if it cannot. Every source lands in a bucket and reports one ready bit when it is searchable. [

**PDFs**

Read as text and as page images, so tables, charts, and scanned pages count. Citations point at the page.](https://www.calypso.so/context/sources) [

**Images**

PNG and JPEG are read for what they depict. A product photo answers a question about the product. Citations point at the image.](https://www.calypso.so/context/sources) [

**Documents**

DOCX, Markdown, and plain text. Citations point at the document.](https://www.calypso.so/context/sources) [

**Web pages**

Point at a URL. The page is crawled, analyzed, and kept as a living source, one per team. Citations point at the page URL.](https://www.calypso.so/context/sources) [

**Data files**

CSV and JSON. Export Excel to CSV before uploading. Citations point at the file.](https://www.calypso.so/context/sources) [

**Code**

Python, TypeScript, Go, Rust, SQL, HTML, YAML, and more. Citations point at the file.](https://www.calypso.so/context/sources) Up to 25 MB per file, 1 to 100 files per batch. [**~~The full list of accepted types, and how each gets in.~~**](https://www.calypso.so/context/sources) **The shape** ## One source layer. Named agents. Answers everywhere. **01 · Buckets** ### **Scoped, durable source memory.** A bucket is a named collection of sources. Ingestion writes into buckets, agents search buckets, and nothing crosses between them unless you bind it. Create one on first use, or provision it by slug. [**Buckets in the docs**](https://www.calypso.so/context/buckets) **The doors** ## Four ways in. One answer. [**API**

**OpenAI-compatible API **

Responses, Chat Completions, and Search at api.calypso.so/v1, with the standard SDKs.](https://www.calypso.so/integrations) [**MCP**

**MCP server **

Ask, search, upload, and manage buckets from Cursor, Claude Desktop, and other MCP clients.](https://www.calypso.so/integrations/mcp) [**n8n**

**n8n community node **

Ask a grounded agent and upload knowledge from workflows.](https://www.calypso.so/integrations/n8n) [**Website**

**Web widget **

One script tag, bound to the agent policy you already tested.](https://www.calypso.so/integrations/whatsapp-web-widget) **Proof** ## Ask a real corpus yourself. [**SpaceX Filing Demo**

**Ask the SpaceX IPO filing like an analyst. **

Grounded across indexed filing sources, including prospectus summaries, risk factors, MD&A, launch vehicle pages, Starlink materials, xAI/X references, charts, and image exhibits. - Official filing corpus - 84 sources - 142.4 MB - Multimodal](https://www.calypso.so/demos/spacex-ipo-filing) [**World Cup Results Demo**

**The World Cup is live. So is 150 years of soccer history — ready to be questioned. **

Grounded in international men's soccer results from 1872 to 2026 — match outcomes, tournaments, venues, shootouts, goalscorers, and historical team names. Fast mode is the default; switch to Medium or Extended anytime for deeper, citation-rich analysis. - 49k+ results - 1872-2026 - Shootouts - Goalscorers](https://www.calypso.so/demos/world-cup-results) **Controls** ## Scoped, traceable, yours. [

**Scoped per bucket**

An agent answers only from the buckets it is bound to. Support never quotes the price list; Sales never reads the return policy.](https://www.calypso.so/context/buckets) [

**A source on every answer**

Inline citations plus a structured source list with page, modality, and a signed link to open the original.](https://www.calypso.so/context/citations) [

**Yours, isolated**

Your knowledge stays in your workspace, never trains shared models, and can be exported or deleted any time.](https://www.calypso.so/context/privacy) **Plans** ## Included in every plan. There is no separate Context SKU. Pick the capacity: knowledge storage, answers per month, and agents. [**Context pricing**](https://www.calypso.so/context/pricing) - **Starter** $19/ month 100 MB of knowledge · 1,000 answers a month - **Pro** $49/ month 1 GB of knowledge · 5,000 answers a month - **Scale** $199/ month 10 GB of knowledge · 25,000 answers a month **Questions and answers** ## Before you load your first bucket. New to the idea? [**~~Read what multimodal RAG is.~~**](https://www.calypso.so/answer-library/what-is-multimodal-retrieval-augmented-generation) **Start today** ## **Load a bucket. Call the agent. Ship.** Start the 14-day trial on Pro limits, create a project API key, and get a cited answer in your first hour. [**Start 14-day free trial**](https://context.calypso.so/join) [**Read the developer docs**](https://docs.calypso.so/context)