Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LM_STUDIO_HOMENoPath to LM Studio home directory~/.lmstudio
HANDY_HISTORY_DBNoPath to Handy history database~/Library/Application Support/com.pais.handy/history.db
HANDY_PROMPTS_DBNoPath to prompt-lab data SQLite database./data/handy-prompts.sqlite
LM_STUDIO_BASE_URLNoBase URL for LM Studio APIhttp://127.0.0.1:1234

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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
capability_reportB

Reports client information and capabilities advertised to this MCP server.

sync_handy_historyA

Reads Handy's local history database without modifying it and imports new raw transcripts into the prompt lab.

list_transcripts_needing_proposalsA

Returns a bounded batch of raw transcripts. Generate a conservative corrected transcript for every record, then call save_correction_proposals.

save_correction_proposalsA

Stores Codex-generated proposals for later user review. Proposals do not enter the evaluation set until the user approves them.

show_annotation_labC

Opens a widget for editing and approving a batch of Codex transcript proposals.

annotation_summaryA

Returns counts for imported, proposed, approved, edited, and skipped transcripts.

load_annotation_recordC

Loads a record from the current annotation widget batch.

save_annotation_and_nextB

Saves a user-reviewed transcript target, then returns the next record in the widget batch.

prepare_optimization_datasetA

Creates a chronological development/holdout split and locks annotation access. Call only from a fresh Codex task that has not seen transcript proposals.

get_development_examplesB

Returns approved raw/target pairs from the development split. Holdout records are never returned.

list_lm_studio_modelsA

Lists downloaded local models and loaded instances from LM Studio. It does not download or change models.

create_prompt_candidateB

Stores an immutable Handy-compatible prompt template, model, and inference settings for evaluation. The prompt must contain ${output}.

run_development_evalA

Sequentially evaluates a candidate against development examples, recording exact-match and latency metrics. LM Studio's prior model state is restored afterward.

get_development_failuresA

Returns detailed failed examples for a development evaluation. Holdout evaluation details are never exposed.

freeze_prompt_candidateC

Freezes a candidate before sealed holdout evaluation.

run_holdout_evalA

Evaluates a frozen candidate on the sealed holdout. Returns aggregate metrics only.

plan_lm_studio_promotionA

Shows the exact LM Studio per-model defaults file and fields that would be changed for a candidate. Makes no changes.

promote_candidate_to_lm_studioA

After form confirmation, backs up and updates LM Studio's per-model defaults for a frozen candidate that completed holdout evaluation. Handy remains read-only.

begin_annotation_cycleA

Unlocks annotation access for newly collected Handy transcripts after explicit confirmation. Use from a fresh annotation task.

Prompts

Interactive templates invoked by user choice

NameDescription
propose-handy-correctionConservative instructions for generating a user-reviewable correction.

Resources

Contextual data attached and managed by the client

NameDescription
handy-annotation-labReview Codex proposals and save user-approved transcript targets.
handy-prompts-aboutCurrent workflow, paths, and privacy boundaries.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/glitchassassin/handy-prompt-optimizer'

If you have feedback or need assistance with the MCP directory API, please join our Discord server