# @lulzasaur9192/agent-infra-mcp

MCP server with **18 tools** for AI agent infrastructure — persistent memory, API drift detection, and HMAC-signed trust receipts.

## Installation

```bash
npx @lulzasaur9192/agent-infra-mcp
```

### Claude Desktop / Cursor

```json
{
  "mcpServers": {
    "agent-infra": {
      "command": "npx",
      "args": ["-y", "@lulzasaur9192/agent-infra-mcp"],
      "env": {
        "AGENT_MEMORY_API_KEY": "your-key",
        "AGENT_DRIFT_API_KEY": "your-key",
        "TRUST_RECEIPT_API_KEY": "your-key"
      }
    }
  }
}
```

## Tools (18)

### Memory (8 tools)
Persistent key-value store with namespaces, metadata, TTL, and FTS5 full-text search.

- **`memory_store`** — Store a memory (namespace + key + value)
- **`memory_store_batch`** — Batch store up to 100 memories
- **`memory_list`** — List memories in a namespace
- **`memory_get`** — Get a specific memory
- **`memory_update`** — Update value, metadata, or TTL
- **`memory_delete`** — Delete a memory or entire namespace
- **`memory_search`** — Full-text search with metadata filtering
- **`memory_stats`** — Usage statistics

### Drift Detection (7 tools)
Monitor API endpoints for unexpected changes with golden test cases and cron scheduling.

- **`drift_create_test`** — Register a golden test (exact/subset/contains/status match)
- **`drift_list_tests`** — List all tests
- **`drift_run_test`** — Execute a test manually
- **`drift_test_history`** — View run history and diffs
- **`drift_update_test`** — Update test configuration
- **`drift_delete_test`** — Remove a test
- **`drift_dashboard`** — Overview with drift rate and response times

### Trust Receipts (3 tools)
HMAC-SHA256 signed, tamper-proof records of agent actions for audit trails.

- **`receipt_issue`** — Issue a signed receipt for an agent action
- **`receipt_verify`** — Verify receipt integrity (online or offline)
- **`receipt_list`** — List receipts with filters

## API Keys

Each service uses its own API key:

| Service | Env Var | API |
|---------|---------|-----|
| Memory | `AGENT_MEMORY_API_KEY` | agent-memory-api |
| Drift | `AGENT_DRIFT_API_KEY` | agent-drift-api |
| Receipts | `TRUST_RECEIPT_API_KEY` | trust-receipt-api |

## License

MIT