Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHELV_API_KEY | Yes | API key for Shelv shelf operations. Required for stdio mode or as a fallback in HTTP mode. | |
| SHELV_MCP_HTTP_HOST | No | The host address to bind for HTTP transport. Defaults to 127.0.0.1. | 127.0.0.1 |
| SHELV_MCP_HTTP_PORT | No | The port to bind for HTTP transport. Defaults to 3334. | 3334 |
| SHELV_MCP_TRANSPORT | No | MCP transport protocol to use (stdio or http). Defaults to stdio. | stdio |
| SHELV_MCP_READ_MAX_BYTES | No | The maximum number of bytes to read from a single file. Defaults to 250000. | 250000 |
| SHELV_MCP_SEARCH_MAX_BYTES | No | The maximum number of total bytes for a search operation. Defaults to 5000000. | 5000000 |
| SHELV_MCP_SEARCH_MAX_FILES | No | The maximum number of files to include in a search. Defaults to 500. | 500 |
| SHELV_MCP_ENABLE_WRITE_TOOLS | No | Set to 'true' to enable tools like create_shelf and hydrate_shelf. | |
| SHELV_MCP_SEARCH_MAX_MATCHES | No | The maximum number of matches to return in a search. Defaults to 200. | 200 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_shelves | List shelves available to the authenticated user |
| get_shelf_tree | Get the full file tree and file contents for a shelf |
| read_shelf_file | Read a single file from a shelf |
| search_shelf | Search for text across files in a shelf |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |