Skip to main content

MCP server for ClassiFinder — secret scanning tools for AI agents

Project description

ClassiFinder MCP Server

An MCP server that gives AI agents the ability to scan text for leaked secrets and redact them before they reach an LLM.

Installation

pip install classifinder-mcp

Setup

Get a free API key at classifinder.ai, then add to your agent config:

Claude Code

{
  "mcpServers": {
    "classifinder": {
      "command": "classifinder-mcp",
      "env": {
        "CLASSIFINDER_API_KEY": "ss_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "classifinder": {
      "command": "classifinder-mcp",
      "env": {
        "CLASSIFINDER_API_KEY": "ss_live_your_key_here"
      }
    }
  }
}

Tools

classifinder_scan

Scan text for leaked secrets and credentials. Returns findings with type, severity, confidence, and remediation guidance.

Agent: "Check this config for secrets"
→ classifinder_scan(text="AWS_ACCESS_KEY_ID=AKIAJGKJHSKLDJFH3284")
→ Found 1 secret: aws_access_key (critical, confidence 0.95)

classifinder_redact

Replace all detected secrets with safe placeholders. Returns clean text safe to forward to any LLM.

Agent: "Clean this before sending to the model"
→ classifinder_redact(text="key=sk_live_EXAMPLE_KEY_HERE")
→ "key=[STRIPE_LIVE_SECRET_KEY_REDACTED]"

What It Detects

106 secret types including AWS keys, Stripe keys, GitHub tokens, OpenAI/Anthropic/Cohere API keys, database connection strings, private keys, credit card numbers, and more.

See Also

For CLI scanning instead of MCP, see cfsniff — a command-line tool that scans files, shell history, and configs for secrets (pipx install cfsniff).

Disclaimer

ClassiFinder is a detection aid, not a guarantee. No scanner catches 100% of secrets in 100% of formats. See our Terms of Service for full details.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

classifinder_mcp-0.1.2rc1.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

classifinder_mcp-0.1.2rc1-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file classifinder_mcp-0.1.2rc1.tar.gz.

File metadata

  • Download URL: classifinder_mcp-0.1.2rc1.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for classifinder_mcp-0.1.2rc1.tar.gz
Algorithm Hash digest
SHA256 c7d5582e1daec46b81befbe0ca87c1b73196b62badc107660be316634c05d5ef
MD5 1d8919be44b96a7e05e09c5a2714c1dd
BLAKE2b-256 c23f079a4fc89813a25b5c7ad2ac18e69bb9a9c982b11c90197ce11bec2d2030

See more details on using hashes here.

Provenance

The following attestation bundles were made for classifinder_mcp-0.1.2rc1.tar.gz:

Publisher: release.yml on ClassiFinder/classifinder-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file classifinder_mcp-0.1.2rc1-py3-none-any.whl.

File metadata

File hashes

Hashes for classifinder_mcp-0.1.2rc1-py3-none-any.whl
Algorithm Hash digest
SHA256 0f9c8bff6a37b49bc50a44e80b2f9e53fdc0060f962f56e1ea42ce0d8288dc43
MD5 be52c5ad9768377c3f1f61d4af33c891
BLAKE2b-256 fcece0a62d73485894bac135a8d72844fbdc310c9cb71b1a804fe5fa1adf7be1

See more details on using hashes here.

Provenance

The following attestation bundles were made for classifinder_mcp-0.1.2rc1-py3-none-any.whl:

Publisher: release.yml on ClassiFinder/classifinder-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page