The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Inflectiv listing page.
Connect any AI agent to the Inflectiv data platform via the Model Context Protocol. Build knowledge bases, create AI agents, run semantic search, upload files, and chat — from any MCP-compatible client.
Works with any AI agent — not limited to coding. Use it for research, customer support, content creation, data pipelines, and multi-agent workflows.
Inflectiv turns raw data (documents, URLs, text, files) into structured, searchable knowledge that AI agents can query and build on. This MCP server gives your agent direct access to:
33 tools and 3 documentation resources, listed below.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Or edit .mcp.json in your project root with the same mcpServers block as above.
Any MCP-compatible client works. Run npx -y @inflectiv-ai/inflectiv-mcp with the INFLECTIV_API_KEY environment variable set.
| Variable | Required | Default | Description |
|---|---|---|---|
INFLECTIV_API_KEY | Yes | — | API key (must start with inf_). See API Keys below. |
INFLECTIV_WALLET_PRIVATE_KEY | No | — | EVM wallet private key for x402 crypto payments. When set and credits hit 0, the server pays per request in USDC on Base.Optional |
There are two kinds of key, and they change how some tools behave:
inf_...) — bound to a single dataset. Dataset-scoped tools operate on that dataset automatically; you never pass dataset_id.inf_global_...) — spans every dataset you own plus active marketplace acquisitions. Dataset-scoped tools accept an optional dataset_id to target a specific dataset, and unlock account-level tools like inflectiv_create_dataset, inflectiv_clone_dataset, and inflectiv_cross_query.| Tool | Description | Cost |
|---|---|---|
inflectiv_list_agents | List all your agents | Free |
inflectiv_create_agent | Create a new AI agent | Paid |
inflectiv_get_agent | Get agent details | Free |
inflectiv_update_agent_config | Update agent settings (model, personality, temperature, etc.) | Paid |
inflectiv_chat_with_agent | Chat with RAG-enabled responses (multi-turn supported) | Paid |
inflectiv_list_agent_datasets | List datasets attached to an agent | Free |
inflectiv_attach_dataset | Attach a dataset to an agent | Free |
inflectiv_update_dataset_mode | Switch between read_only and self_learning | Free |
| Tool | Description | Cost |
|---|---|---|
inflectiv_list_datasets | List accessible datasets | Free |
inflectiv_create_dataset | Create a new dataset*(global key)* | Paid |
inflectiv_clone_dataset | Clone an accessible dataset into your account*(global key)* | Free |
inflectiv_update_dataset | Update dataset name, description, and instructions | Free |
inflectiv_reindex_dataset | Reindex vectors (run after bulk changes) | Paid |
inflectiv_search_dataset | Semantic search across a dataset | Paid |
inflectiv_batch_search | Run up to 20 searches in one call | Paid |
inflectiv_cross_query | One query across many datasets*(global key + advanced tier)* | Paid |
inflectiv_list_knowledge_sources | List all sources (files, URLs, text, AI-generated) | Free |
| Tool | Description | Cost |
|---|---|---|
inflectiv_write_intelligence | Write a knowledge entry (auto-embedded & deduplicated) | Paid |
inflectiv_batch_write_intelligence | Write up to 50 entries in one call | Paid |
inflectiv_list_intelligence | List entries with filtering & pagination | Free |
| Tool | Description | Cost |
|---|---|---|
inflectiv_upload_file | Upload a local file as a knowledge source | Paid |
inflectiv_list_files | List uploaded files | Free |
inflectiv_get_file | Get file details & processing status | Free |
inflectiv_reprocess_file | Retry a failed file upload | Paid |
Supported formats: PDF, DOCX, TXT, MD, HTML, XML, CSV, JSON, JSONL, TSV, XLSX, XLS, Parquet
| Tool | Description | Cost |
|---|---|---|
inflectiv_register_webhook | Subscribe to events (HTTPS only) | Free |
inflectiv_list_webhooks | List registered webhooks | Free |
inflectiv_test_webhook | Send a test event to verify your endpoint | Free |
Events: intelligence.processed, intelligence.failed, intelligence.deduped, dataset.mode_changed
| Tool | Description | Cost |
|---|---|---|
inflectiv_chainaware_fraud | Predictive fraud / AML risk for a wallet | Paid |
inflectiv_chainaware_rug_pull | Predictive rug-pull risk for a wallet | Paid |
inflectiv_chainaware_credit_score | On-chain credit score for a wallet | Paid |
inflectiv_chainaware_behaviour | Predictive behaviour profile for a wallet | Paid |
inflectiv_chainaware_token_rank | Ranked token list for a network (paged, sortable) | Paid |
inflectiv_chainaware_token_rank_single | Ranking for a single token by contract address | Paid |
Requires the chainaware_api feature on your subscription tier. Calls spend from the paid credit pool; same-day repeat lookups are cached for free, and unprovisioned wallet lookups are not charged.
Each tool's full parameters and credit cost are described in its tool definition, which your MCP client surfaces automatically.
Once connected, ask your AI agent in natural language:
The server can pay for paid operations automatically using USDC on Base via the x402 protocol — no top-up needed. Set INFLECTIV_WALLET_PRIVATE_KEY to a funded EVM wallet; when an API call returns 402 Payment Required, the server signs and retries the request with payment.
⚠️ A wallet private key grants full control of that wallet. Use a dedicated, low-balance wallet, never your primary one, and never commit or share the key.
The server also exposes reference resources any MCP client can read:
| URI | Content |
|---|---|
inflectiv://docs/overview | Authentication, concepts, getting started |
inflectiv://docs/webhook-events | Event types and payload examples |
inflectiv://docs/credit-costs | Full credit cost table |
The server is published as @inflectiv-ai/inflectiv-mcp on npm and runs automatically via npx — no build or installation step required. All processing is handled server-side by the Inflectiv platform.
MIT © Inflectiv