Greenspark

Fetch the complete documentation index at: https://docs.getgreenspark.com/llms.txt. Use this file to discover all available pages before exploring further.

MCP

El servidor Model Context Protocol (MCP) de Greenspark permite que editores de IA (Cursor, Windsurf, VS Code) y herramientas como Claude Desktop trabajen con la documentación de la API de Greenspark y, cuando esté habilitado, con llamadas de API en vivo de solo lectura contra tu cuenta.

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto para conectar aplicaciones de IA a herramientas y datos externos. El servidor MCP de Greenspark (alojado por ReadMe) brinda a los agentes:

• Acceso a la referencia de la API — listar e inspeccionar endpoints, parámetros y esquemas de respuesta
• Contexto de documentación — especificaciones OpenAPI y guías de Greenspark
• Llamadas en vivo de solo lectura (v1) — execute-request en rutas GET habilitadas cuando proporcionas una clave de API válida
• Ayuda de integración — respuestas basadas en esquemas y ejemplos de solicitudes para desarrollar con Greenspark

Límites de v1: MCP es de solo lectura. Las rutas POST, PUT, PATCH y DELETE están documentadas para construir integraciones; usa get-endpoint para esquemas, no execute-request para escrituras. Billing, Email y Estimations no están expuestos mediante los interruptores de rutas de MCP en v1.

Requisitos previos

1. Una cuenta de Greenspark con una clave de API (crea claves en el panel después del registro).
2. Coincide la clave con el host: clave de sandbox → https://sandbox.getgreenspark.com; clave de producción → https://api.getgreenspark.com.
3. Para las primeras pruebas, usa una clave de sandbox.

La autenticación usa el encabezado x-api-key en las llamadas de API en vivo. Algunos clientes de MCP te permiten adjuntar encabezados a la configuración del servidor MCP; de lo contrario, el agente pasa la clave al llamar a execute-request.

Servidor MCP de Greenspark

URL: https://docs.getgreenspark.com/mcp

No se requiere contraseña de MCP para v1 (déjala en blanco en la configuración de MCP de ReadMe).

Añade a `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "greenspark": {
      "url": "https://docs.getgreenspark.com/mcp",
      "headers": {
        "x-api-key": "YOUR_SANDBOX_OR_PRODUCTION_API_KEY"
      }
    }
  }
}
```

Reinicia Cursor después de guardar. Prefiere una clave de **sandbox** mientras pruebas.

Añade a tu configuración de MCP en VS Code (extensión Copilot / MCP):

```json
{
  "mcpServers": {
    "greenspark": {
      "url": "https://docs.getgreenspark.com/mcp",
      "headers": {
        "x-api-key": "YOUR_SANDBOX_OR_PRODUCTION_API_KEY"
      }
    }
  }
}
```

Añade a `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "greenspark": {
      "url": "https://docs.getgreenspark.com/mcp",
      "headers": {
        "x-api-key": "YOUR_SANDBOX_OR_PRODUCTION_API_KEY"
      }
    }
  }
}
```

Añade a `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "greenspark": {
      "url": "https://docs.getgreenspark.com/mcp",
      "headers": {
        "x-api-key": "YOUR_SANDBOX_OR_PRODUCTION_API_KEY"
      }
    }
  }
}
```

Nota: Si tu cliente no admite encabezados en la URL de MCP, conéctate sin ellos y proporciona x-api-key cuando el agente ejecute execute-request contra los hosts de Greenspark.

Qué puedes hacer en v1

Herramienta MCP	Propósito
list-specs / list-endpoints	Explorar especificaciones OpenAPI y rutas
get-endpoint	Esquema completo para una operación
search-endpoints	Encontrar rutas por palabra clave
execute-request	Solo GET, en rutas habilitadas en la configuración de MCP de ReadMe
get-server-variables	Sugerencias de entorno / URL del servidor desde la especificación

Especificaciones con exposición MCP en v1: Impact, Reporting, Account, Projects.

No ejecutables mediante interruptores de MCP v1: Estimations, Email, Billing (solo documentación).

Algunas rutas requieren planes de suscripción o tipos de clave específicos; las llamadas fallidas pueden devolver 401, 403 o 422 (cuota de API agotada).

Kit de instalación para clientes y habilidades de agente

El servidor MCP se ejecuta en ReadMe en https://docs.getgreenspark.com/mcp. Para configuraciones de editor, habilidades de agente y metadatos de registro, usa el repositorio público de GitHub:

github.com/getgreenspark/mcp

Recurso	Enlace
Ejemplos de clientes MCP (Cursor, VS Code, Windsurf, Claude Desktop)	examples/
Habilidades de agente	skills/
Registro de cambios	CHANGELOG.md
Problemas (habilidades, ejemplos, configuración del repositorio)	Problemas de GitHub

Las habilidades son opcionales. Ayudan a los agentes a usar Greenspark MCP correctamente (autenticación, entornos y flujos de trabajo GET de dominio). No reemplazan los esquemas en vivo de get-endpoint en este sitio de documentación.

Instalación (ejemplo con Cursor):

npx skills add getgreenspark/mcp -a cursor -g -y

## Testing your setup

1. Connect your editor to `https://docs.getgreenspark.com/mcp` (with sandbox `x-api-key` if supported).
2. Open a new agent chat and confirm the Greenspark MCP tools are listed.
3. Try read-only prompts, for example:
   * "List Greenspark MCP endpoints for Account."
   * "Show the schema for GET public account v2."
   * "Using my sandbox key, call GET /v2/account/ with my account ID" (only if that route is enabled in ReadMe).
4. Confirm **write** operations are not run via MCP — ask for a POST example as code in your app instead.

For machine-readable docs without MCP, see [`https://docs.getgreenspark.com/llms.txt`](https://docs.getgreenspark.com/llms.txt).