Skip to main content

Dossier MCP server

Onchain risk scoring for Base, callable by AI agents (Claude, Cursor, …) over the Model Context Protocol. A thin client over the Dossier REST API.

Tools

Tool What it answers Score direction
dossier_scan_token Is this token a honeypot / rug / high-risk? risk — higher = worse
dossier_scan_deployer Can I trust the dev who shipped it? trust — higher = better
dossier_scan_portfolio How exposed is this wallet (holdings + approvals)? risk — higher = worse

Risk and trust are kept as separate scores with explicit direction — never collapsed into one number.

Configuration (env)

Var Default Purpose
DOSSIER_API_BASE http://localhost:8000 Base URL of the Dossier REST API
DOSSIER_MCP_TRANSPORT stdio stdio (local) or http (streamable-HTTP, remote)
DOSSIER_MCP_HOST / DOSSIER_MCP_PORT 127.0.0.1 / 8765 bind address for HTTP transport

Use it from Claude Desktop / Cursor (stdio)

{
  "mcpServers": {
    "dossier": {
      "command": "uvx",
      "args": ["dossier-mcp"],
      "env": { "DOSSIER_API_BASE": "https://your-dossier-host" }
    }
  }
}

Or from a local checkout: uv run dossier-mcp (with DOSSIER_API_BASE pointing at your backend).

Run as a hosted HTTP server (multi-client)

DOSSIER_MCP_TRANSPORT=http DOSSIER_MCP_PORT=8765 DOSSIER_API_BASE=http://localhost:8000 uv run dossier-mcp

Agents then connect to the streamable-HTTP endpoint at http://host:8765/mcp.

Example

"Is 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 safe to buy on Base?"

The agent calls dossier_scan_token → "USDC — risk: low (29/100, higher = worse; 60% confidence)…", then can follow up with dossier_scan_deployer on the attributed creator.

Dossier provides risk intelligence, not financial advice; false positives and negatives are possible.

Metadata

Release files for dossier-mcp 0.1.0

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

Source distribution (sdist)

Source distribution for dossier-mcp 0.1.0
File Size Uploaded
dossier_mcp-0.1.0.tar.gz 63.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for dossier-mcp 0.1.0
File Interpreter ABI Platform
dossier_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 70.8 kB

Release files / dossier_mcp-0.1.0.tar.gz

Download URL dossier_mcp-0.1.0.tar.gz
Size 63.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d7c316766d1e0900a1c137858c42e80e1c292d8daf6d098b4e8aa160af9050f7
BLAKE2b-256 checksum
How to use checksums
7e9744442491fa6a32fb52a2f1f1af8ed5bd896c462f619ceea2e5e9b0126556
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / dossier_mcp-0.1.0-py3-none-any.whl

Download URL dossier_mcp-0.1.0-py3-none-any.whl
Size 7.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c8a5c73b2fd37e005799d256f7d5c067e58e13629fc501a7e7ec1ad64466bfac
BLAKE2b-256 checksum
How to use checksums
95d15a9169d4a33d2925355b0ecb217110be002d718d82b6b4f0b2c7544853a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

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