# eve-mcp

One Memory. Every Agent.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add eve/eve-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list eve/eve-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get eve/eve-mcp memory_store

# Call a tool
npx -y @smithery/cli@latest tool call eve/eve-mcp memory_store '{}'
```

## Direct MCP Connection

Endpoint: `https://eve-mcp--eve.run.tools`

**Optional config:**
- `X-API-Key` (header) — Authorization header

## Tools (14)

- `memory_store` — Store a piece of knowledge into memory.
- `memory_search` — Search memory using a natural language query.
- `memory_get_preferences` — Get stored preferences for a context. Use at session start to load behavioral preferences.
- `memory_pre_compaction` — Save a list of critical facts as episodic entries before context compaction.
- `memory_session_start` — Log the beginning of a conversation or work session.
- `memory_session_end` — Log the end of a session.
- `memory_extract` — Extract memorable facts, preferences, and events from transcript text.
- `memory_ingest` — Start a batch ingestion job from a conversation export file.
- `memory_ingest_status` — Poll the status of a running ingestion job.
- `memory_feedback` — Record consumer feedback on a retrieved memory chunk.
- `memory_forget` — Soft-delete (retract) a semantic memory chunk by its chunk_id.
- `memory_update` — Update an existing memory. If text changes, facts are re-extracted.
- `memory_pre_compact` — Distill raw conversation messages into memories using AI extraction
- `memory_ingest_url` — Ingest a web URL into memory.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get eve/eve-mcp <tool-name>
```