@inf-mcp/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,309 @@
+# @inflectiv/mcp-server
+
+Connect AI coding assistants to the [Inflectiv](https://app.inflectiv.ai) platform. Create agents, manage knowledge, search your data, build skills from project memories, 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 @inflectiv/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 @inflectiv/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", "@inflectiv/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", "@inflectiv/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", "@inflectiv/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", "@inflectiv/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", "@inflectiv/mcp-server"],
+      "env": {
+        "INFLECTIV_API_KEY": "inf_global_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Any Other MCP Client
+
+Run `npx -y @inflectiv/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 | Skills, marketplace, multi-dataset access |
+
+---
+
+## Tools (38)
+
+### 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`
+
+### Memory (5) — no API key needed
+
+Local-only tools. Memories are stored in `.inflectiv/memory/` in the project root. Works completely offline.
+
+| Tool | Description | Credits |
+|------|-------------|---------|
+| `inflectiv_write_memory` | Write a memory entry with category, tags, importance | Free |
+| `inflectiv_list_memories` | List memories with optional filters | Free |
+| `inflectiv_search_memories` | Keyword search over local memories | Free |
+| `inflectiv_delete_memory` | Delete a memory entry by ID | Free |
+| `inflectiv_suggest_skill_creation` | Analyze memories and recommend if ready for skill creation | Free |
+
+### Skills (4) — requires API key
+
+| Tool | Description | Credits |
+|------|-------------|---------|
+| `inflectiv_create_skill` | Synthesize memories into a reusable skill document | 5 |
+| `inflectiv_apply_skill` | Apply a skill to an agent (injects into system prompt + RAG) | 2 |
+| `inflectiv_list_skills` | List owned and acquired skills | Free |
+| `inflectiv_scan_skill_security` | Preview security scan before creating (passes 1-4) | Free |
+
+### Marketplace (5) — browsing is public, acquiring requires API key
+
+| Tool | Description | Credits | Auth |
+|------|-------------|---------|------|
+| `inflectiv_browse_skill_marketplace` | Browse published skills with search & filters | Free | None |
+| `inflectiv_get_skill_listing` | Get skill listing detail | Free | None |
+| `inflectiv_acquire_skill` | Acquire a skill (free or paid) | Varies | API key |
+| `inflectiv_browse_dataset_marketplace` | Browse published datasets | Free | None |
+| `inflectiv_browse_agent_marketplace` | Browse published agents | Free | None |
+
+### Auth Summary
+
+| Category | Count | API Key? |
+|----------|-------|----------|
+| Memory (local-only) | 5 | No |
+| Marketplace browsing | 4 | No |
+| **Subtotal (no key)** | **9** | |
+| Agents, Datasets, Files, Webhooks, Knowledge | 24 | Yes |
+| Skills | 4 | Yes |
+| Marketplace acquire | 1 | Yes |
+| **Subtotal (key required)** | **29** | |
+
+---
+
+## 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"
+
+Memory (works offline, no API key):
+"Remember that we use Tailwind CSS with the 'cn' helper"
+"List all my project memories"
+"Search memories for database migration"
+"Am I ready to create a skill from my memories?"
+
+Skills:
+"Create a skill from my memories called 'React Patterns'"
+"Apply skill 12 to agent 5"
+"Scan this skill content for security issues"
+
+Marketplace (browsing works without API key):
+"Browse the skill marketplace for Python tools"
+"Show me the top-rated agent listings"
+"Acquire skill listing 42"
+```
+
+## Web Dashboard
+
+Skills can also be managed through the Inflectiv web UI at [app.inflectiv.ai](https://app.inflectiv.ai):
+
+- **`/skills`** — View your skills, acquired skills, and marketplace listings
+- **`/skills/sell`** — Create a marketplace listing for a skill (security screening required)
+- **`/marketplace`** (Skills tab) — Browse and acquire skills from the community
+- **`/marketplace/skills/{id}`** — Skill detail page with reviews
+
+Skills are delivered encrypted via the MCP server only — the web UI is for management, browsing, and selling, not content access.
+
+---
+
+## 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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }