Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NAN_API_KEYYesAPI key de NaN (obligatoria)
NAN_BASE_URLNoBase URL de la API (default https://api.nan.builders/v1)https://api.nan.builders/v1
NAN_OUTPUT_DIRNoDirectorio de salida (default ~/nan-mcp-output)~/nan-mcp-output

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
}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_imageA

Generate an image from a text prompt with flux-2-klein (default) or qwen-image-2.1 (NaN API). qwen-image-2.1 is text-to-image only and renders text inside the image more cleanly; use edit_image when you already have reference images to transform. Saves each image under NAN_OUTPUT_DIR (default ~/nan-mcp-output) and never overwrites: a taken name gets -2, -3, and so on. Returns the saved path and the temporary source URL. Counts against the account image quota (100/month, shared by both image models).

list_voicesA

List the kokoro voice ids that text_to_speech accepts, grouped by language. Answered from the catalog bundled with the server, so it costs no API call and takes no arguments.

text_to_speechA

Synthesize speech from text with kokoro (NaN API TTS); speech_to_text does the opposite. Call list_voices first to pick a voice id. Writes the audio under NAN_OUTPUT_DIR (default ~/nan-mcp-output) without overwriting anything, and returns the saved path and its size in bytes.

speech_to_textA

Transcribe a local audio file with whisper (NaN API STT); text_to_speech does the opposite. The file must exist on this machine and stay under 25MB and about 2 minutes, or the request times out. Returns the plain transcript, or the full JSON with per-segment timings when verbose is set. Writes nothing to disk.

list_modelsA

List the NaN API model ids the configured key can reach, one per line with its owner. Useful to confirm access or spot a retired model before calling another tool.

get_quotaA

Report the legacy per-model token quota from the NaN dashboard backend (GET /api/usage/quota): used, cap, remaining and reset date, worst-utilised model first. Since NaN moved to a credit pool these counters can be frozen, and a line is flagged when its counter lags behind real activity; use get_usage for real consumption and the credit balance. Read-only and free. Undocumented route that accepts the same sk- key; it may change without notice.

get_usageA

Report real consumption and the credit pool from NaN (GET /v1/usage): credits used, remaining and reset date, then per-model requests, input/output/cached tokens and credits, with totals. Defaults to the current credit period. Prefer this over get_quota, whose counters can be stale. Read-only and free. Undocumented endpoint that accepts the same sk- key; it may change without notice.

embed_textA

Turn text into 4096-dimension vectors with qwen3-embedding (NaN API) for RAG or semantic search; rerank_documents then orders whatever a search over those vectors brings back. Returns only a summary — item count, dimensions and input tokens — because the vectors are far too large to put in the conversation, so use this to populate a store rather than to read values.

rerank_documentsA

Order documents by how well they answer a query, with Qwen3-Reranker-8B (NaN API). This is the second half of a RAG pipeline: embed_text builds the vectors a search runs over, and this one ranks what that search returns. Returns one line per document with its relevance score and its position in the input list, in the order the reranker gives them back.

edit_imageA

Transform existing images with flux-2-klein image-to-image (NaN API). Use generate_image instead when starting from text alone. Takes 1 to 4 local reference files (PNG, JPEG or WebP, each under 25MB), saves the result under NAN_OUTPUT_DIR (default ~/nan-mcp-output) without overwriting anything, and returns the saved path and the temporary source URL. Counts against the shared account image quota (100/month, flux-2-klein and qwen-image-2.1).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 10 tools

Disambiguation5/5

Every tool has a distinct purpose, and potentially overlapping pairs are explicitly differentiated in their descriptions: get_quota vs get_usage (legacy vs real consumption), generate_image vs edit_image (text-to-image vs image-to-image), and embed_text vs rerank_documents (the two halves of a RAG pipeline). speech_to_text and text_to_speech are clearly opposite directions, and list_models vs list_voices target different catalogs.

Naming Consistency5/5

All ten tools use snake_case with a predictable verb_noun or noun_relation pattern (get_quota, generate_image, list_models, speech_to_text). No mixing of camelCase, casing, or verb styles.

Tool Count5/5

Ten tools is well within the ideal 3-15 range and each maps to a distinct capability of a multi-modal API (image gen/edit, embeddings, reranking, TTS, STT, model/voice listing, usage/quota). Nothing feels padded or missing at the count level.

Completeness4/5

The surface covers image generation/editing, embeddings, reranking, speech in both directions, catalog listing, and usage reporting, which is broad lifecycle coverage for a multi-modal API. A text-generation/chat completion tool and any way to inspect or manage saved output files are notable gaps, but agents can work around them for the stated modalities.

Maintenance

ActivityActive
ResponsivenessNo recent community issues