openai-cookbook
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GEMINI_API_KEY | Yes | Gemini API key used for ingest-time embeddings and entity extraction. Set in the environment or in a gitignored .env.local. |
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_kgA | Search the OpenAI Cookbook knowledge base using hybrid vector + KG-walk retrieval. Returns ranked passages with source references. Best for: API usage patterns, model comparisons, code examples. |
| get_docA | Retrieve a specific Cookbook document or chunk by its ID or partial source file path. Use after search_kg to read the full content. |
| kg_statsA | Return corpus statistics: total chunks, KG nodes/edges, entity type breakdown, most-connected nodes. |
| find_exemplarA | Find canonical code examples for an OpenAI API pattern. Searches Jupyter code cells specifically. Use for: 'show me how to do X', 'canonical example of Y'. |
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 4 tools
search_kg and find_exemplar both handle code-example lookups, which could cause misselection, but their descriptions clarify the distinction (general retrieval vs. canonical Jupyter-cell examples). get_doc and kg_stats are clearly separate.
Three tools follow a verb_noun pattern (search_kg, get_doc, find_exemplar), but kg_stats is a noun phrase, a minor deviation. Style is otherwise consistent (lowercase underscores).
Four tools fit the server's read-only knowledge-base purpose well: search, retrieve, specialized search, and stats. Each earns its place without redundancy or bloat.
The domain is querying the OpenAI Cookbook, and the core workflow (search, retrieve full content, find code examples) is fully covered. kg_stats adds useful corpus metadata, and no obvious dead ends remain.