# Calypso Multimodal RAG MCP (npm · @calypsohq/multimodal-rag-mcp-server)

Calypso multimodal RAG for grounded answers from docs, images, charts, and knowledge.

- Trust score: 69/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@calypsohq/multimodal-rag-mcp-server`: 69/100 (this document), [markdown](https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server.md), [page](https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@calypsohq/multimodal-rag-mcp-server`
- Version: `1.0.37`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (124 of 125), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (124 of 125), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 54 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 75/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1712 tokens (~171/item across 10 items; 5 tools + 5 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add calypso-so-multimodal-rag-mcp-server -- npx -y @calypsohq/multimodal-rag-mcp-server
```

### Codex

```bash
codex mcp add calypso-so-multimodal-rag-mcp-server -- npx -y @calypsohq/multimodal-rag-mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "calypso-so-multimodal-rag-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add calypso-so-multimodal-rag-mcp-server --command npx --arg -y --arg @calypsohq/multimodal-rag-mcp-server
```

### Hermes

```yaml
mcp_servers:
  calypso-so-multimodal-rag-mcp-server:
    command: "npx"
    args: ["-y", "@calypsohq/multimodal-rag-mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "calypso-so-multimodal-rag-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@calypsohq/multimodal-rag-mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 69, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-02 (score 65, +40)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional] Licence: MIT

### 2026-08-01 (score 25, +20)

- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100

### 2026-07-31 (score 5, −19)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 24, −27)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

### 2026-07-27 (score 51)

First indexed and scored.

## MCP tools (5)

### `calypso-list-knowledge-buckets` (~116 tokens)

[CALYPSO LIST KNOWLEDGE BUCKETS]
Lists knowledge buckets for the team tied to the configured Calypso API key.

Use this before uploads when you need bucket ids, slugs, names, member counts,
or bucket-store readiness. This complements RAG model discovery: model discovery
shows which buckets are bound to each agent variant, while this tool lists all buckets for the API key team.

Input parameters:

- `includeArchived` (boolean): If true, include archived buckets. Defaults to false.

### `calypso-upload-agent-file` (~355 tokens)

[CALYPSO UPLOAD AGENT FILE]
Uploads a file through the agent-facing API, backed by one durable knowledge bucket.

Use this when you want a compatible `file_id` that can be attached to `calypso-rag-agent`.
The MCP sends `purpose=user_data`, targets the selected RAG agent with `target_model`,
passes exactly one `bucket_id`, and can optionally wait until the file is RAG-ready before returning.
For Claude, Smithery, browser, or hosted-agent uploads, pass `contentBase64`; use `filePath` only when this MCP process can read that exact local path.
Bucket bindings by model: calypso-rag-agent: no active buckets configured.

Input parameters:

- `bucketId` (string): Required when the selected model has multiple buckets. Auto-selected when the selected model has exactly one active bucket.
- `contentBase64` (string): Base64-encoded file content. Recommended for Claude, Smithery, browser, and remote-agent uploads because the MCP process receives the bytes directly.
- `filePath` (string): Advanced local-only path. Use only when the Calypso MCP server is running on the same filesystem and can read this exact path; hosted attachment paths such as /mnt/user-data/uploads usually require c…
- `filename` (string, required): Display filename for the uploaded file.
- `mimeType` (string, required): Content type for the uploaded file.
- `targetModel` (string): Optional RAG agent id. Defaults to `calypso-rag-agent`. Available models: calypso-rag-agent.
- `waitForReady` (boolean): If true, wait until the uploaded file is RAG-ready before returning.

### `calypso-upload-knowledge-file` (~428 tokens)

[CALYPSO UPLOAD KNOWLEDGE FILE]
Uploads a file into the durable bucket-backed knowledge store and indexing pipeline.

Use this when you want a file indexed into the broader knowledge corpus instead of
attached directly to a single RAG chat turn. This tool returns knowledge-file and task metadata.
A bucket destination is required: pass bucketIds, bucketSlugs, or bucket.
For Claude, Smithery, browser, or hosted-agent uploads, pass `contentBase64`; use `filePath` only when this MCP process can read that exact local path.

Input parameters:

- `bucket` (string): Convenience single bucket slug for this upload. Required unless bucketIds or bucketSlugs is provided.
- `bucketIds` (array): Existing knowledge bucket ids to assign this upload to. Required unless bucketSlugs or bucket is provided.
- `bucketSlugs` (array): Knowledge bucket slugs to assign this upload to. Required unless bucketIds or bucket is provided.
- `contentBase64` (string): Base64-encoded file content. Recommended for Claude, Smithery, browser, and remote-agent uploads because the MCP process receives the bytes directly.
- `createMissingBuckets` (boolean): If true, create missing bucket slugs before assignment.
- `filePath` (string): Advanced local-only path. Use only when the Calypso MCP server is running on the same filesystem and can read this exact path; hosted attachment paths such as /mnt/user-data/uploads usually require c…
- `filename` (string, required): Display filename for the uploaded knowledge file.
- `idempotencyKey` (string): Optional idempotency key for durable upload retries.
- `metadata` (object): Optional metadata object serialized onto the upload request.
- `mimeType` (string, required): Content type for the uploaded knowledge file.
- `tags` (array): Optional tags for knowledge-store organization.
- `title` (string): Optional human-readable title stored with the knowledge file.
- `waitForIndexing` (boolean): If true, wait until indexing reaches a terminal ready state before returning.

### `calypso-upload-knowledge-files-batch` (~333 tokens)

[CALYPSO UPLOAD KNOWLEDGE FILES BATCH]
Uploads 1 to 100 files into the durable knowledge store and indexing queue in one request.

Use this for bulk corpus ingestion. Shared bucket fields apply to every item unless an item
provides its own bucket fields. The tool returns batch-level status and, when requested,
polls until the batch reaches active, partially_active, partially_failed, failed, or timeout.
A shared bucket destination is required unless every item provides its own bucket destination.
For Claude, Smithery, browser, or hosted-agent uploads, pass `contentBase64` per item; use `filePath` only for files local to this MCP process.

Input parameters:

- `batchIdempotencyKey` (string, required): Required idempotency key used to derive the durable batch id.
- `bucket` (string): Convenience single bucket slug applied to all items by default. Required unless every item has a bucket destination.
- `bucketIds` (array): Existing bucket ids applied to all items by default. Required unless every item has a bucket destination.
- `bucketSlugs` (array): Bucket slugs applied to all items by default. Required unless every item has a bucket destination.
- `createMissingBuckets` (boolean): If true, create missing shared bucket slugs before assignment.
- `dryRun` (boolean): If true, validate the batch request without storing files.
- `items` (array, required): Knowledge files to upload in this batch.
- `waitForBatchReady` (boolean): If true, poll batch status with include_items=true until terminal or timeout.

### `calypso-rag-agent` (~352 tokens)

[CALYPSO RAG AGENT]
Sends each prompt directly to the Calypso RAG agent using the full conversation context.

Use this when you want Calypso knowledge retrieval and grounded answers from the RAG backend.
Typical requests:
\- "Summarize the key points from our onboarding documentation"
\- "What does the knowledge base say about campaign approval rules?"
\- "Compare the documented indexing flow with the retrieval flow"
\- "Answer using the uploaded file ids: [\"file_123\"]"

Responses API behavior:
\- First turns start a named Calypso conversation via `/v1/responses`.
\- Follow-up turns chain with `previous_response_id` so the backend owns conversation state.
\- When `fileIds` are provided, the MCP uses `rag_policy` retrieval semantics instead of inline attachment stuffing.

MCP session behavior:
\- This tool maintains a stable conversation id in the background for multi-turn retrieval context.
\- Use `/new` to start a fresh conversation and clear the current context window.

Quick commands (examples):
\- "Summarize the latest indexed knowledge about WhatsApp templates"
\- "Find the source of truth for campaign approval behavior"
\- "Start a new topic" (or use `/new`)

Available RAG models: calypso-rag-agent.

Input parameters:

- `fileIds` (array): Optional uploaded agent-store `file_id` values to attach with `rag_policy` retrieval semantics.
- `model` (string): Optional RAG model variant. Defaults to `calypso-rag-agent`. Available models: calypso-rag-agent.
- `prompt` (string, required): Your request. Include context, constraints, and desired output.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server#diagnostics

## Score history

- 2026-08-03: 69
- 2026-08-02: 65
- 2026-08-01: 25
- 2026-07-31: 5
- 2026-07-30: 24
- 2026-07-28: 51
- 2026-07-27: 51

## Links

- npm package: https://www.npmjs.com/package/@calypsohq/multimodal-rag-mcp-server
- Socket report: https://socket.dev/npm/package/@calypsohq/multimodal-rag-mcp-server
- Repository: https://github.com/calypso-so/calypso-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/calypso-so-multimodal-rag-mcp-server/calypsohq-multimodal-rag-mcp-server