nan-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NAN_API_KEY | Yes | API key de NaN (obligatoria) | |
| NAN_BASE_URL | No | Base URL de la API (default https://api.nan.builders/v1) | https://api.nan.builders/v1 |
| NAN_OUTPUT_DIR | No | Directorio 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
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.
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.
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.
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.