# context MCP server

> Provides an MCP layer to retrieve recent trends and events between conversations to give LLMs personalized, short-term context.

- Repository: https://github.com/Runtime-Roost/context-server
- Page: https://hostedmcp.org/servers/runtime-roost/context-server
- Transport: —
- Stars: 1
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `EMBEDDINGS_AUTO_PULL` | no | no |  |
| `EMBEDDINGS_ENABLED` | no | no |  |
| `EMBEDDINGS_MODEL` | no | no |  |
| `EMBEDDINGS_PROVIDER` | no | no |  |
| `OLLAMA_HOST` | no | no |  |

## Tools (46)

- `ping`
- `identify_actor`
- `save_context`
- `search_context`
- `get_user_profile`
- `list_recent_context`
- `get_context`
- `acknowledge_context`
- `request_actor_session`
- `get_actor_session_request_status`
- `claim_actor_session`
- `renew_actor_session`
- `create_channel`
- `add_channel_member`
- `remove_channel_member`
- `list_channels`
- `save_channel_context`
- `search_channel_context`
- `list_channel_context`
- `get_channel_context`
- `update_channel_context`
- `delete_channel_context`
- `create_access_group`
- `add_access_group_member`
- `remove_access_group_member`
- `list_access_groups`
- `save_group_context`
- `search_group_context`
- `list_group_context`
- `get_group_context`
- `update_group_context`
- `delete_group_context`
- `save_personal_context`
- `search_personal_context`
- `list_personal_context`
- `get_personal_context`
- `update_personal_context`
- `delete_personal_context`
- `database_metadata`
- `delete_context`
- `update_context`
- `context_purge_preview`
- `context_purge_confirm`
- `actor_purge_preview`
- `actor_purge_confirm`
- `vacuum_database`

## FAQ

### How do I configure the server?

You can generate a machine-specific configuration file by running `npm run mcp:config` or using the `MCP: Generate config` task in VS Code.

### Can I manage the database automatically?

Yes, by setting the `AUTO_MANAGE_DB` environment variable to `true`, the server will check for the database and create it if it is missing.

### How does the server handle privacy for direct messages?

Private message bodies are excluded from SQL queries entirely, and the Inspection API returns an envelope that explicitly confirms contents are not exposed.

### What happens if I don't identify an actor?

The save will still succeed but will be recorded with `actor: null` and trigger an `ACTOR_NOT_IDENTIFIED` warning.