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

Capabilities

Features and capabilities supported by this server

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