--- type: DC asset_id: DC-EL-GHL-EndpointsYMCP-v01 version: v01 status: Draft owner: Juan Carlos sherpa_owner: JuanCarlosX fecha_creacion: 2026-06-10 fecha_ultima_actualizacion: 2026-06-10 intellbank: IB-EL-EmpowerLabs subbank: BOS-EL-WORX-OS proposito: Referencia canónica de endpoints REST y herramientas MCP disponibles en GoHighLevel API v2 · insumo para integración Claude + GHL --- ## Asset Header - **Asset ID:** DC-EL-GHL-EndpointsYMCP-v01 - **Version:** v01 - **Status:** Draft - **Owner:** Juan Carlos - **Sherpa:** JuanCarlosX - **IntellBank:** IB-EL-EmpowerLabs - **SubBank:** BOS-EL-WORX-OS - **Tipo:** DC — Documento de Consulta - **Propósito:** Referencia canónica de endpoints REST y herramientas MCP disponibles en GoHighLevel API v2 · insumo para integración Claude + GHL - **Fecha creación:** 2026-06-10 - **Última actualización:** 2026-06-10 --- # GoHighLevel — Endpoints disponibles & MCP Server **Fuente:** [marketplace.gohighlevel.com/docs](https://marketplace.gohighlevel.com/docs/) --- ## ⚡ Hallazgo clave: MCP Server oficial de GHL GHL tiene un **servidor MCP nativo** listo para conectar con Claude (y cualquier cliente compatible con HTTP Streamable). **Endpoint:** ``` https://services.leadconnectorhq.com/mcp/ ``` **Configuración mínima:** ```json { "mcpServers": { "ghl-mcp": { "url": "https://services.leadconnectorhq.com/mcp/", "headers": { "Authorization": "Bearer TU_PRIVATE_INTEGRATION_TOKEN", "locationId": "TU_LOCATION_ID" } } } } ``` **Cómo obtener el token:** Settings → Private Integrations → Create New Integration (selecciona los scopes necesarios). **36 herramientas disponibles vía MCP** (ver sección §2). > ⚠️ Nota: el cliente `npx` para Claude Desktop está en roadmap pero aún no está disponible. La conexión actual requiere un cliente que soporte HTTP Streamable (Claude Code sí lo soporta). --- ## §1 — Categorías de endpoints REST (API 2.0) | Categoría | URL de documentación | |---|---| | OAuth 2.0 | `/docs/ghl/oauth/oauth-2-0` | | Ad Manager | `/docs/ghl/ad-manager/ad-manager-api` | | Affiliate Manager | `/docs/ghl/affiliate-manager/affiliate-manager-api` | | AI Agent Studio | `/docs/ghl/agent-studio/agent-studio-apis` | | Associations | `/docs/ghl/associations/associations-api` | | Blogs | `/docs/ghl/blogs/blogs-api` | | Brand Boards | `/docs/ghl/brand-boards/brand-boards-api` | | Business | `/docs/ghl/businesses/business-api` | | **Calendars** | `/docs/ghl/calendars/calendars-api` | | Campaigns | `/docs/ghl/campaigns/campaigns-api` | | Chat Widget | `/docs/ghl/chat-widget/chat-widget-api` | | Companies | `/docs/ghl/companies/companies-api` | | **Contacts** | `/docs/ghl/contacts/contacts-api` | | Conversation AI | `/docs/ghl/conversation-ai/conversation-ai-api` | | **Conversations** | `/docs/ghl/conversations/conversations-api` | | Courses | `/docs/ghl/courses/memberships-api` | | Custom Fields V2 | `/docs/ghl/custom-fields/custom-fields-v-2-api` | | Custom Menus | `/docs/ghl/custom-menus/custom-menus-api` | | LC Email | `/docs/ghl/email-isv/lc-email` | | Email | `/docs/ghl/emails/email-api` | | Forms | `/docs/ghl/forms/forms-api` | | **Funnels** | `/docs/ghl/funnels/funnels-api` | | Invoice | `/docs/ghl/invoices/invoice-api` | | Knowledge Base | `/docs/ghl/knowledge-base/knowledge-base-api` | | Trigger Links | `/docs/ghl/links/trigger-links-api` | | Sub-Account (Location) | `/docs/ghl/locations/sub-account-formerly-location-api` | | Developer Marketplace | `/docs/ghl/marketplace/developer-marketplace-api` | | Media Storage | `/docs/ghl/medias/media-storage-api` | | Objects (Custom) | `/docs/ghl/objects/custom-objects-api` | | **Opportunities** | `/docs/ghl/opportunities/opportunities-api` | | **Payments** | `/docs/ghl/payments/payments-api` | | Phone System | `/docs/ghl/phone-system/phone-system-api` | | Products | `/docs/ghl/products/products-api` | | Proposals / Docs & Contracts | `/docs/ghl/proposals/documents-and-contracts-api` | | SaaS | `/docs/ghl/saas/saas-api` | | Snapshots | `/docs/ghl/snapshots/snapshots-api` | | Social Planner | `/docs/ghl/social-planner/social-media-posting-api` | | Store | `/docs/ghl/store/store-api` | | Surveys | `/docs/ghl/surveys/surveys-api` | | Users | `/docs/ghl/users/users-api` | | Voice AI | `/docs/ghl/voice-ai/voice-ai-api` | | Workflows | `/docs/ghl/workflows/workflows-api` | | **Webhooks** (50+ eventos) | `/docs/category/webhook` | > ⚠️ **No existe una API de "Websites" independiente.** La edición de sitios web via API no está disponible directamente — los Funnels tienen su propia API pero los Websites (constructor de sitios) no exponen endpoints REST públicos en la v2. Esto es relevante para la tarea 2. **Versión:** API v2 (versión activa). La v1 llegó a end-of-support el 31 de diciembre de 2025. --- ## §2 — Herramientas disponibles vía MCP Server (36 tools) | # | Tool | Endpoint MCP | Qué hace | |---|---|---|---| | 1 | Get Calendar Events | `calendars_get-calendar-events` | Obtiene eventos de calendario | | 2 | Get Appointment Notes | `calendars_get-appointment-notes` | Notas de cita | | 3 | Get All Tasks | `contacts_get-all-tasks` | Tareas de un contacto | | 4 | Add Tags | `contacts_add-tags` | Agrega tags a contacto | | 5 | Remove Tags | `contacts_remove-tags` | Elimina tags de contacto | | 6 | Get Contact | `contacts_get-contact` | Detalle de contacto | | 7 | Update Contact | `contacts_update-contact` | Actualiza contacto | | 8 | Upsert Contact | `contacts_upsert-contact` | Crea o actualiza contacto | | 9 | Create Contact | `contacts_create-contact` | Crea contacto | | 10 | Get Contacts | `contacts_get-contacts` | Lista contactos | | 11 | Search Conversation | `conversations_search-conversation` | Busca/filtra conversaciones | | 12 | Get Messages | `conversations_get-messages` | Mensajes por conversación | | 13 | Send a New Message | `conversations_send-a-new-message` | Envía mensaje a conversación | | 14 | Get Location | `locations_get-location` | Detalles de sub-cuenta | | 15 | Get Custom Fields | `locations_get-custom-fields` | Campos personalizados de la location | | 16 | Search Opportunity | `opportunities_search-opportunity` | Busca oportunidades | | 17 | Get Pipelines | `opportunities_get-pipelines` | Lista pipelines | | 18 | Get Opportunity | `opportunities_get-opportunity` | Oportunidad por ID | | 19 | Update Opportunity | `opportunities_update-opportunity` | Actualiza oportunidad | | 20 | Get Order by ID | `payments_get-order-by-id` | Detalle de orden de pago | | 21 | List Transactions | `payments_list-transactions` | Lista transacciones (paginado) | | 22 | Edit Posts | `social-media-posting_edit-post` | Edita post de redes sociales | | 23 | Create Posts | `social-media-posting_create-post` | Crea post multi-plataforma | | 24 | Get Post | `social-media-posting_get-post` | Detalle de post | | 25 | Get Social Media Accounts | `social-media-posting_get-account` | Cuentas conectadas | | 26 | Get Social Media Statistics | `social-media-posting_get-social-media-statistics` | Analytics de redes | | 27 | Get Posts | `social-media-posting_get-posts` | Lista posts | | 28 | Check URL Slug | `blogs_check-url-slug-exists` | Valida disponibilidad de slug | | 29 | Get Blog Post | `blogs_get-blog-post` | Posts de un blog | | 30 | Get Blog Categories | `blogs_get-all-categories-by-location` | Categorías del blog | | 31 | Create Blog Post | `blogs_create-blog-post` | Crea post de blog | | 32 | Get All Blog Authors | `blogs_get-all-blog-authors-by-location` | Autores del blog | | 33 | Get All Blogs | `blogs_get-blogs` | Lista blogs | | 34 | Update Blog Post | `blogs_update-blog-post` | Actualiza post | | 35 | Get Email Templates | `emails_fetch-template` | Templates de email | | 36 | Create Email Template | `emails_create-template` | Crea template de email | --- ## §3 — Límites de la API (rate limits) - **100 requests / 10 segundos** por app Marketplace por recurso - **200,000 requests / día** por app Marketplace por recurso --- ## §4 — Notas para la integración Claude + GHL (Tarea 2) **Ruta recomendada:** usar el MCP Server oficial en lugar de construir llamadas REST directas. **Para Claude Code:** configura el MCP en `.claude/settings.json` o `claude_desktop_config.json` con el token PIT y el locationId. **Para Funnels via API:** sí existe endpoint REST (`/funnels`). Permite listar funnels y manejar redirects. La edición de páginas individuales de un funnel es limitada. **Para Websites:** no hay API pública REST para el constructor de sitios web de GHL. La edición debe hacerse directamente en la UI o explorando la extensión de Chrome como alternativa (scope de la tarea 2). **Roadmap GHL MCP:** están trabajando en expandir a 250+ tools y añadir soporte OAuth. El `npx` package para Claude Desktop está pendiente. --- ## Referencias - [Documentación oficial API 2.0](https://marketplace.gohighlevel.com/docs/) - [MCP Server GHL](https://marketplace.gohighlevel.com/docs/other/mcp) - [Funnels API](https://marketplace.gohighlevel.com/docs/ghl/funnels/funnels-api/) - [Developer Portal](https://developers.gohighlevel.com/)