@dropdat/mcp
OfficialThe @dropdat/mcp server allows AI clients to interact with a user's dropdat capsule library — a personal knowledge store for saving and retrieving AI conversations — through the following tools:
Semantic Search (
dropdat_recall): Perform hybrid vector + BM25 search across capsule titles, summaries, and message bodies to find relevant past conversations or decisions, with optional tag filtering and result limits.Read Capsule (
dropdat_read): Fetch the full message contents of a specific capsule by its ID, with an optional flag to include its lineage.Browse Recent Capsules (
dropdat_list): List recently saved capsules, optionally filtered by tag, for browsing rather than targeted searching.Save a Conversation Slice (
dropdat_capsule): Save a meaningful portion of the current conversation as a new capsule, with a title, messages, summary, tags, and source metadata.Autosave Full Session (
dropdat_autocapsule): Save an entire Claude Code session verbatim by reading the on-disk.jsonltranscript directly, requiring only a title and optional metadata.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@dropdat/mcprecall capsules about natural language processing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@dropdat/mcp
MCP server for dropdat. Lets any MCP-capable AI client (Claude Code, Cursor, Cline, Claude Desktop) recall, read, and save capsules in the user's dropdat library.
Tools
Tool | Purpose |
| Keyword-search capsules (titles, summaries, message bodies). |
| Fetch one capsule's full contents by id (optional lineage). |
| Browse recent capsules, optional tag filter. |
| Save the current conversation slice as a new capsule (model picks the messages). |
| Save the full verbatim Claude Code session by reading the on-disk |
dropdat_recall calls the hybrid /capsules/search endpoint
(vector + BM25 fused via RRF). Set OPENAI_API_KEY on the API for
full semantic recall; without it the endpoint degrades to BM25.
Related MCP server: StashDog MCP Server
Install
# from npm (recommended — clients can also `npx -y @dropdat/mcp`)
npm install -g @dropdat/mcp
# or from source
git clone https://github.com/dropdat/mcp.git
cd mcp && npm install && npm run buildConfigure
Issue an API key in the dashboard → API Keys (token shown once,
shape dk_live_…). Export it:
export DROPDAT_API_KEY=dk_live_xxx
# Optional — defaults to https://dropdat.app, the hosted API.
# Set this only if you're running the API locally or self-hosted.
# export DROPDAT_API_BASE=http://localhost:8080If you're self-hosting the API and have DEV_AUTH_BYPASS=1 enabled,
the API ignores tokens entirely and assumes DEV_USER_ID. Use a real
key against any normal deployment.
Wire into a client
Claude Code
Add to ~/.claude/mcp.json (or project .mcp.json):
{
"mcpServers": {
"dropdat": {
"command": "npx",
"args": ["-y", "@dropdat/mcp"],
"env": {
"DROPDAT_API_KEY": "dk_live_xxx"
}
}
}
}Cursor / Cline / Claude Desktop
Same shape — npx -y @dropdat/mcp as the command, DROPDAT_API_KEY
in env. Transport is stdio.
Develop
npm run dev # tsx, no rebuild
npm run build # emit dist/The compiled dist/index.js starts with a #!/usr/bin/env node
shebang and is chmod +x'd on build — once published, clients can
npx -y @dropdat/mcp instead of pinning a path.
Endpoint surface used
All against the Go API under /api/v1:
GET /capsules?q=&tag=&limit=POST /capsules/searchGET /capsules/{id}GET /capsules/{id}/lineagePOST /capsules
Bearer auth — accepts either a Clerk session JWT or a dk_* API key.
The MCP server uses the API-key path so it survives long-running
agent sessions without a refresh dance.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/dropdat/mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server