Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: deprecated for now

Moatdrop MCP Server

An MCP (Model Context Protocol) server for Moatdrop — manage secure, trackable links from AI assistants like Claude Desktop, Cursor, and Claude Code.

Installation

pip install moatdrop-mcp

Or run directly with uvx:

uvx moatdrop-mcp

Setup

1. Get an API Key

  1. Log in to Moatdrop
  2. Go to Account > API Keys
  3. Create a new key and copy it

2. Configure Your AI Assistant

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "moatdrop": {
      "command": "uvx",
      "args": ["moatdrop-mcp"],
      "env": {
        "MOATDROP_API_KEY": "mdp_your_key_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP config (.cursor/mcp.json):

{
  "mcpServers": {
    "moatdrop": {
      "command": "uvx",
      "args": ["moatdrop-mcp"],
      "env": {
        "MOATDROP_API_KEY": "mdp_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add moatdrop -- uvx moatdrop-mcp

Then set the environment variable:

export MOATDROP_API_KEY="mdp_your_key_here"

Environment Variables

Variable Required Default Description
MOATDROP_API_KEY Yes — Your Moatdrop API key (mdp_...)
MOATDROP_API_URL No https://api.moatdrop.com API base URL (for self-hosted or dev)

Available Tools

Tool Description
create_link Create a secure link with URL, expiration, IP rules, click limits
list_links List all your secure links
get_link Get full details of a specific link
update_link Update link name, expiration, click limits
delete_link Permanently delete a link (requires confirm=true)
enable_link Re-enable a revoked link
disable_link Revoke/disable a link

Document Queries

Tool Description
deep_extraction Ask a question and get an AI-synthesized answer from a shared file

Analytics & Account

Tool Description
get_link_analytics Get raw access logs for a link
get_analytics_summary Aggregated analytics: clicks, unique IPs, top countries, referrers
get_account_info Your account details and plan tier

Available Resources

URI Description
moatdrop://links Summary list of all your links
moatdrop://links/{id} Full details for a specific link
moatdrop://links/{id}/analytics Access logs for a specific link
moatdrop://account Your account info

Querying Files with AI Agents

MoatDrop lets you upload files, create secure links, and then query those files through AI agents using the MCP server. Here's how to set it up end to end.

Log in to MoatDrop, click + Create Moat Link, and upload your file (PDF, DOCX, XLSX, etc.). Once created, note the moat link — this is the short code in the secure URL (e.g., if the URL is https://moatdrop.com/l/abc123, the moat link is abc123).

You can find the moat link on the link detail page under Moat Link.

Step 2: Create a share token

Share tokens let you grant someone query-only access to a specific file without sharing your full API key.

  1. Go to the link detail page for your file
  2. Expand AI Agent Access > Show Setup
  3. Under Create Share Token, enter a name (e.g., "For Acme Corp")
  4. Optionally set an expiration (hours) and max uses
  5. Click Create Token
  6. Copy the token (starts with mds_) — it's shown only once

Step 3: Configure the MCP server

Give the share token to whoever needs to query the file. They add this to their AI assistant config:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "moatdrop": {
      "command": "uvx",
      "args": ["moatdrop-mcp"],
      "env": {
        "MOATDROP_API_KEY": "mds_your_share_token_here"
      }
    }
  }
}

Cursor / VS Code

Add to .cursor/mcp.json or VS Code MCP settings:

{
  "mcpServers": {
    "moatdrop": {
      "command": "uvx",
      "args": ["moatdrop-mcp"],
      "env": {
        "MOATDROP_API_KEY": "mds_your_share_token_here"
      }
    }
  }
}

Claude Code

claude mcp add moatdrop -- uvx moatdrop-mcp

Then set the environment variable:

export MOATDROP_API_KEY="mds_your_share_token_here"

Step 4: Query the file

Once connected, ask your AI assistant to query the file using the moat link:

Deep extraction (AI-synthesized answers):

"Use the deep_extraction tool with moat_link abc123 and ask: What are the key findings in this report?"

The tool sends the full document to Gemini in a single call and returns a synthesized answer with PII scrubbed.

Share token vs API key

Share Token (mds_) API Key (mdp_)
Scope Query access to one specific file Full account access
Safe to share Yes No
Can manage links No Yes
Can view analytics No Yes
Expiration Optional (configurable) Optional
Usage limits Optional (configurable) None

Examples

Once configured, you can ask your AI assistant:

  • "Use deep_extraction with hash abc123: What is the executive summary?"
  • "Use deep_extraction with hash abc123: What date was the contract signed?"
  • "Use deep_extraction with hash abc123: Pull the termination clauses from this contract"

Development

# Clone and install in dev mode
cd mcp-server
pip install -e .

# Run with a local backend
MOATDROP_API_KEY=mdp_test MOATDROP_API_URL=http://localhost:8000 moatdrop-mcp

# Run tests
pip install pytest
pytest tests/

License

MIT

Metadata

Release files for moatdrop-mcp 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for moatdrop-mcp 0.3.1
File Size Uploaded Provenance Actions
moatdrop_mcp-0.3.1.tar.gz 13.5 kB Without provenance Details for moatdrop_mcp-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for moatdrop-mcp 0.3.1
File Interpreter ABI Platform Actions
moatdrop_mcp-0.3.1-py3-none-any.whl Python 3 none any Details for moatdrop_mcp-0.3.1-py3-none-any.whl

Total release size: 27.7 kB

Release files / moatdrop_mcp-0.3.1.tar.gz

Download URL moatdrop_mcp-0.3.1.tar.gz
Size 13.5 kB
Tags Source
SHA-256 checksum
How to use checksums
eeabbd44aac72c55f3fc28bb21ca5d92ce54c91635c179575a6b92fee76370d0
BLAKE2b-256 checksum
How to use checksums
0a1a3d0e9e4abf4447363a2249151256d37823ed4abf6f05c84460f916ac4282
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / moatdrop_mcp-0.3.1-py3-none-any.whl

Download URL moatdrop_mcp-0.3.1-py3-none-any.whl
Size 14.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4065bc27006f8f721ef8bbd6782c5cb35611dc44128b178b4fd8d67741de796c
BLAKE2b-256 checksum
How to use checksums
e78878ec48974ebe765acd940ea249c1d76dfecaa1fc801d18b17f2aa10f08ba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Security for moatdrop-mcp 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page