Project Oracle
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ORACLE_DIR | No | Root directory for all Oracle state | ~/.project-oracle |
| ANTHROPIC_API_KEY | No | Required only for oracle_ask Haiku fallback |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| oracle_readA | Read a file, returning full content on first read or a compact delta on repeat reads. |
| oracle_grepB | Search source files for a regex pattern. Returns up to 50 matches. |
| oracle_statusA | Return current project status: stack info, git branch, clean/dirty state. |
| oracle_runB | Run allowlisted commands through the cache layer. Returns cached results when unchanged. |
| oracle_askC | Ask a natural-language question about the project. Routes to cache, grep, or Haiku. |
| oracle_forgetA | Clear the file cache for a path. Next oracle_read returns full content. |
| oracle_statsA | Return token savings stats for the current session and cumulative across all sessions. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a distinct purpose: ask natural-language questions, clear cache, search files, read files, run commands, show stats, and show status. There is no functional overlap.
All tools follow the consistent pattern 'oracle_verb' in lowercase snake_case (ask, forget, grep, read, run, stats, status). Even 'stats' and 'status' are noun-like but are used as imperative verbs in this context, maintaining a uniform style.
Seven tools is an ideal size for a focused project assistant. Each tool covers a necessary operation without being too few or overwhelming.
The set covers key operations: querying, reading, searching, running commands, caching, and stats. A minor gap might be the lack of a tool to list directory contents, but oracle_ask can potentially handle that via natural language.