npm package: @inf-mcp/mcp-server
Description: MCP server for the Inflectiv AI platform — manage agents, datasets, skills, marketplace, memories, and files from any MCP-compatible IDE
Latest version: 0.3.0

# @inf-mcp/mcp-server

Connect AI coding assistants to the [Inflectiv](https://app.inflectiv.ai) 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](https://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)

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

To update your key later:

```bash
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):

```json
{
  "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:

```json
{
  "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):

```json
{
  "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):

```json
{
  "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):

```json
{
  "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](https://app.inflectiv.ai))

## License

MIT