Perchance MCP Lite
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Port for the server. Render sets automatically (8000). | 8000 |
| SOLVER_URL | No | The URL of the Byparr/Camoufox solver on a separate Render account, e.g., https://perchance-solver.onrender.com. Used to solve Turnstile and generate images. Recommended for 512MB. | |
| PERCHANCE_USER_KEY | No | 64-char hex from browser localStorage; manual, no solver. Used when SOLVER_URL is not set. Valid 30s IP-bound. |
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
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_stylesA | List all available art styles for Perchance Stable Diffusion. |
| get_generator_infoB | Get information about the generator and lite mode. |
| get_user_key_statusA | Check if cached userKey is valid and solver status. |
| get_ad_codeA | Get current ad access code via curl_cffi (no browser, unlimited). |
| generate_imageA | Generate an image via lite mode (curl_cffi + external solver). Memory: 80-120MB (no browser). If SOLVER_URL set, calls solver service (Byparr/Camoufox) that does Turnstile solving (200MB) on separate Render account. If no solver, requires PERCHANCE_USER_KEY env var (64 hex from browser). Args: prompt: What to draw negative_prompt: Things to avoid seed: -1 random or specific int resolution: 512x512, 512x768, 768x512, 768x768 guidance_scale: 1-30 default 7 art_style: Optional style from list_styles save_path: Where to save (default auto) Returns JSON with saved_path, seed, etc. |
| generate_batchC | Generate multiple images via lite mode. |
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 6 tools
Most tools have clear, distinct purposes: style listing, generator info, key status, ad code, and image generation. However, generate_image and generate_batch share the same core action and may cause agents to hesitate when choosing which suits a task, though their singular vs. batch nature provides adequate separation.
All tool names follow a consistent verb_noun pattern in snake_case: list_, get_, and generate_. Even the batch and single image tools share the generate_ prefix, making the set predictable and easy to navigate.
With 6 tools, this server is well-scoped for a lightweight Perchance image generation interface. Each tool maps to a distinct functional area (styles, generator info, auth status, ad access, single/batch generation) without unnecessary bloat.
The core workflow is covered: discover styles, check key validity, and generate single or batch images. Minor gaps exist—such as no explicit tool to set or refresh the user key (relying on env var/solver) and no ability to list or retrieve generated images—but these are reasonable for a 'lite' server.