Greenspark

El MCP de Greenspark permite a los creadores de IA y agentes añadir fácilmente acciones climáticas verificadas, como plantar árboles, recuperar plástico oceánico, proteger abejas, restaurar algas, compensar carbono y financiar agua limpia, directamente en sus productos y flujos de trabajo.

Ver en getgreenspark.comPrueba este MCPPatrocinado

Documentación

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 con herramientas y datos externos. El servidor MCP de Greenspark (alojado por ReadMe) ofrece a los agentes:

  • Acceso a la referencia de la API — lista e inspecciona 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 MCP en v1.

Requisitos previos

  1. Una cuenta de Greenspark con una clave de API (crea claves en el panel de control 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 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 MCP para v1 (déjala en blanco en la configuración 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 MCP de 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 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 MCPPropósito
list-specs / list-endpointsExplora especificaciones OpenAPI y rutas
get-endpointEsquema completo para una operación
search-endpointsEncuentra rutas por palabra clave
execute-requestSolo GET, en rutas habilitadas en la configuración MCP de ReadMe
get-server-variablesSugerencias de entorno / URL del servidor desde la especificación

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

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

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

Kit de instalación para clientes y Agent Skills

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

github.com/getgreenspark/mcp

RecursoEnlace
Ejemplos de clientes MCP (Cursor, VS Code, Windsurf, Claude Desktop)examples/
Agent Skillsskills/
Registro de cambiosCHANGELOG.md
Problemas (skills, ejemplos, configuración del repositorio)GitHub issues

Las Skills son opcionales. Ayudan a los agentes a usar Greenspark MCP correctamente (autenticación, entornos y flujos de trabajo GET del 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).