@inf-mcp/mcp-server

Connect AI coding assistants to the Inflectiv platform. Create agents, manage knowledge, search your data, browse marketplaces, and chat — all from your IDE.

Quick Start

1. Get an API key from app.inflectiv.ai → Settings → API Keys
2. Pick your IDE below and paste the config
3. Ask your AI: "list my agents" or "search my dataset for X"

Installation

Claude Code (one command)

claude mcp add inflectiv -e INFLECTIV_API_KEY=inf_global_your_key_here -- npx -y @inf-mcp/mcp-server

To update your key later:

claude mcp remove inflectiv
claude mcp add inflectiv -e INFLECTIV_API_KEY=inf_global_new_key -- npx -y @inf-mcp/mcp-server

Claude Desktop

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

{
  "mcpServers": {
    "inflectiv": {
      "command": "npx",
      "args": ["-y", "@inf-mcp/mcp-server"],
      "env": {
        "INFLECTIV_API_KEY": "inf_global_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Create .vscode/mcp.json in your project root:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "inflectiv-api-key",
      "description": "Inflectiv API Key (from app.inflectiv.ai → Settings → API Keys)",
      "password": true
    }
  ],
  "servers": {
    "inflectiv": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inf-mcp/mcp-server"],
      "env": {
        "INFLECTIV_API_KEY": "${input:inflectiv-api-key}"
      }
    }
  }
}

Or hardcode the key (not recommended for shared repos):

{
  "servers": {
    "inflectiv": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inf-mcp/mcp-server"],
      "env": {
        "INFLECTIV_API_KEY": "inf_global_your_key_here"
      }
    }
  }
}

Cursor

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "inflectiv": {
      "command": "npx",
      "args": ["-y", "@inf-mcp/mcp-server"],
      "env": {
        "INFLECTIV_API_KEY": "inf_global_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or %APPDATA%\Codeium\windsurf\mcp_config.json (Windows):

{
  "mcpServers": {
    "inflectiv": {
      "command": "npx",
      "args": ["-y", "@inf-mcp/mcp-server"],
      "env": {
        "INFLECTIV_API_KEY": "inf_global_your_key_here"
      }
    }
  }
}

Any Other MCP Client

Run npx -y @inf-mcp/mcp-server with the INFLECTIV_API_KEY environment variable set. Works with any MCP-compatible client using stdio transport.

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | INFLECTIV_API_KEY | Yes* | — | API key (inf_* dataset-scoped or inf_global_* account-level) | | INFLECTIV_BASE_URL | No | https://app.inflectiv.ai/api/platform | Override API URL | | INFLECTIV_WALLET_PRIVATE_KEY | No* | — | Private key for X402 crypto payments (alternative to credits) |

*At least one of INFLECTIV_API_KEY or INFLECTIV_WALLET_PRIVATE_KEY is required.

API Key Types

| Key Format | Scope | Use Case | |------------|-------|----------| | inf_* | Single dataset | Dataset-specific operations | | inf_global_* | Full account | Marketplace, multi-dataset access |

Tools (26)

Agents (8) — requires API key

| Tool | Description | Credits | |------|-------------|---------| | inflectiv_list_agents | List all your agents | Free | | inflectiv_create_agent | Create a new AI agent | 5 | | inflectiv_get_agent | Get agent details | Free | | inflectiv_update_agent_config | Update agent settings (model, personality, temperature, etc.) | 2 | | inflectiv_chat_with_agent | Chat with RAG-enabled responses (supports multi-turn) | 1 | | 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 |

Datasets & Search (8) — requires API key

| Tool | Description | Credits | |------|-------------|---------| | inflectiv_list_datasets | List accessible datasets | Free | | inflectiv_update_dataset | Update dataset name/description | Free | | inflectiv_reindex_dataset | Reindex vectors (run after bulk changes) | 2 | | inflectiv_search_dataset | Semantic search across your knowledge base | 1 | | inflectiv_batch_search | Run up to 20 searches in one call | 1/query | | inflectiv_write_intelligence | Write a knowledge entry (auto-embedded & deduplicated) | 1 (0 if dup) | | inflectiv_batch_write_intelligence | Write up to 50 entries in one call | 1/new entry | | inflectiv_list_intelligence | List entries with filtering & pagination | Free |

Knowledge Sources (1) — requires API key

| Tool | Description | Credits | |------|-------------|---------| | inflectiv_list_knowledge_sources | List all sources (files, URLs, text, AI-generated) | Free |

Files (4) — requires API key

| Tool | Description | Credits | |------|-------------|---------| | inflectiv_upload_file | Upload a local file as a knowledge source | 5 + 1/MB over 5MB | | inflectiv_list_files | List uploaded files | Free | | inflectiv_get_file | Get file details & processing status | Free | | inflectiv_reprocess_file | Retry a failed file upload | 5 |

Supported formats: PDF, DOCX, TXT, MD, HTML, CSV, JSON, JSONL, TSV, XLSX, XLS, Parquet, XML

Webhooks (3) — requires API key

| Tool | Description | Credits | |------|-------------|---------| | 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

Marketplace (2) — public, no auth required

| Tool | Description | Credits | |------|-------------|---------| | inflectiv_browse_dataset_marketplace | Browse published datasets with search & filters | Free | | inflectiv_browse_agent_marketplace | Browse published agents with search & filters | Free |

Auth Summary

| Category | Count | API Key? | |----------|-------|----------| | Marketplace browsing | 2 | No | | Subtotal (no key) | 2 | | | Agents, Datasets, Files, Webhooks, Knowledge | 24 | Yes | | Subtotal (key required) | 24 | |

Examples

"List my agents"
"Create an agent called Support Bot with a friendly personality"
"Upload my-data.pdf to the dataset"
"Search my knowledge base for refund policy"
"Chat with agent 42: What are the return deadlines?"
"Write this text as intelligence: <your knowledge>"
"Register a webhook at https://example.com/hook for processed events"

Marketplace (browsing works without API key):
"Show me the top-rated agent listings"
"Browse the dataset marketplace for Python tutorials"

Resources

The server also exposes MCP resources for reference:

| 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 |

Requirements

• Node.js 18+
• An Inflectiv API key (get one here)

License

MIT