bluesurf-mcp-node
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BLUESURF_COOKIE | No | Cookie de sesión ya válida → usa CookieAuth. Se acepta SURF_COOKIE como fallback. | |
| BLUESURF_BASE_URL | No | URL base (opcional; default https://surf.bluepeople.com). Se acepta SURF_BASE_URL como fallback. | |
| BLUESURF_PASSWORD | No | Contraseña para CredentialsAuth. Se acepta SURF_PASSWORD como fallback. | |
| BLUESURF_USERNAME | No | Usuario para CredentialsAuth. Se acepta SURF_USERNAME como fallback. |
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 |
|---|---|
| mis_proyectosA | Lista los proyectos del usuario (id, smallCode, code, name). El smallCode (p. ej. "PROJ") es lo que se pasa a buscar_mis_tickets. |
| buscar_mis_ticketsB | Lista los tickets asignados al usuario en un proyecto de BlueSurf. |
| obtener_ticketC | Devuelve el detalle de un ticket de BlueSurf por su código (p. ej. PROJ-123). |
| listar_adjuntosA | Lista los archivos de la sección Files de un ticket, sin descargarlos. |
| descargar_adjuntosA | Descarga los adjuntos de un ticket a una carpeta local. Con archivo_id descarga solo uno; si no, todos. |
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 5 tools
Each tool has a clearly distinct role: listing projects, listing assigned tickets, retrieving ticket detail, listing attachments, and downloading attachments. The only adjacent pair, listar_adjuntos and descargar_adjuntos, is explicitly differentiated by listing vs downloading.
The names are consistently snake_case and mostly follow a Spanish verb_noun pattern. The minor deviation is mis_proyectos, which is a noun phrase rather than verb-led, and buscar_mis_tickets includes a possessive but remains understandable.
Five tools are well-scoped for a focused BlueSurf project/ticket/attachment workflow. Each tool earns its place without obvious redundancy.
The set covers the core read path: projects to assigned tickets to ticket detail to attachment listing/download. Minor gaps remain around broader ticket search/filtering and write operations such as creating or updating tickets, but the main browsing workflow is usable.