Skip to main content

Pluck MCP Server

Connect your Pluck knowledge graph to Claude Desktop, Cursor, and other MCP-compatible AI tools.

Install

pip install pluck-mcp

Or install from source:

cd mcp-server
pip install -e .

Configuration

Set these environment variables:

Variable Required Default Description
PLUCK_INTEGRATION_API_KEY Yes — API key from Settings > Integrations in Pluck
PLUCK_INTEGRATION_BASE_URL No https://www.pluckagent.com Base URL of your Pluck instance

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_..."
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_..."
      }
    }
  }
}

Claude Code

Add to your Claude Code MCP settings (.claude/settings.json):

{
  "mcpServers": {
    "pluck": {
      "command": "pluck-mcp",
      "env": {
        "PLUCK_INTEGRATION_API_KEY": "plk_live_..."
      }
    }
  }
}

Self-hosted? Set PLUCK_INTEGRATION_BASE_URL to your instance URL (e.g. http://localhost:8100 for local dev).

Available Tools

Tool Description
ask_pluck Ask a question and get a researched answer with knowledge graph context
list_document_types List all document types discovered in the knowledge graph
get_schema_fields Get schema fields for a specific document type
vector_search Semantic search across documents and chunks
query_documents Query documents with filtering and sorting
get_entity_neighbors Explore entity relationships in the knowledge graph
get_full_text Retrieve full text of a document or chunk
upload_file Upload a local file for knowledge graph ingestion
build_knowledge_graph Start building a knowledge graph from files/sources
get_ingestion_status Poll pipeline progress (status, neo4j_ready)
connect_source Get OAuth URL to connect a data source
check_source_connection Check if OAuth flow completed
list_connected_sources List all sources and connection status
browse_cloud_files Browse files in a connected cloud source

Ingestion tools require an API key with the ingest:write scope.

Development

cd mcp-server
pip install -e .
PLUCK_INTEGRATION_API_KEY=plk_live_... pluck-mcp

Metadata

Release files for pluck-mcp 0.2.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 pluck-mcp 0.2.0
File Size Uploaded Provenance Actions
pluck_mcp-0.2.0.tar.gz 7.2 kB Without provenance Details for pluck_mcp-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pluck-mcp 0.2.0
File Interpreter ABI Platform Actions
pluck_mcp-0.2.0-py3-none-any.whl Python 3 none any Details for pluck_mcp-0.2.0-py3-none-any.whl

Total release size: 15.7 kB

Release files / pluck_mcp-0.2.0.tar.gz

Download URL pluck_mcp-0.2.0.tar.gz
Size 7.2 kB
Tags Source
SHA-256 checksum
How to use checksums
559b14660d5162e5e889de4d15120409f09b113c9857d1c7b5a483d27b6f8447
BLAKE2b-256 checksum
How to use checksums
69a59497c58d11d4163745032dabf1cfa41bdfe26bf998e68e17fa81ab5a06f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Release files / pluck_mcp-0.2.0-py3-none-any.whl

Download URL pluck_mcp-0.2.0-py3-none-any.whl
Size 8.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d78bda4f0b5f5f50215f6bc1322b3fe4d7ca3bfc5f7f1cf93c0fc9493ea4ba68
BLAKE2b-256 checksum
How to use checksums
7e0cdff402f56a2c5872a73ce9905e7119ca7cc65a0db6ed8e14bc4f8cead24f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.2

Security for pluck-mcp 0.2.0

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.

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