Celigo README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Celigo listing page.
Celigo AI
One-stop shop for building integrations on the Celigo platform with AI.
This repo contains:
- Skills -- domain knowledge for AI coding assistants (Claude Code, Cursor, Codex, and 50+ more)
- MCP Prompts & Resources -- content served by the Celigo MCP server
Install Skills
Install specific skills
Install as a Plugin
This repo is also a native plugin marketplace for Claude Code and Cursor, bundling all of the skills below plus the Celigo Platform MCP server.
Claude Code -- in the app, or with the claude CLI:
Cursor -- install Celigo from the Cursor plugin marketplace (Settings -> Plugins). Team admins can add this repo directly under Team Marketplaces.
Codex -- run codex plugin marketplace add celigo/ai, then install celigo from the Plugins Directory in the ChatGPT desktop app.
For 50+ other agents, use the skills install above.
Installing the plugin also configures the Celigo Platform MCP server (https://api.integrator.io/celigo-mcp). It authenticates via OAuth -- the first time an agent uses it, you'll be prompted to sign in to Celigo, so no API token is required.
The plugin ships the US endpoint. Each region runs its own identity provider, so if your account lives in the EU, AU, or CA, the sign-in won't complete against it -- configure your region's endpoint by hand instead (https://api.eu.integrator.io/celigo-mcp, https://api.au.integrator.io/celigo-mcp, or https://api.ca.integrator.io/celigo-mcp). See Regions.
Using a different client -- VS Code, Windsurf, Gemini CLI, Codex CLI, or Claude Desktop? See Connect the Celigo MCP server for copy-paste config and a one-click Add to Cursor button.
Skills
Skill how-tos show celigo CLI commands, but most operations map directly to the bundled Celigo Platform MCP server's tools (list_* / upsert_* / delete_resource / run_flow / deploy_template), so agents connected over MCP follow the same skills and translate the command blocks. A few admin surfaces (the local account index, API tokens, stacks, on-premise agents, users) remain CLI/REST/UI-only.
| Skill | Description |
|---|---|
| getting-started | Core concepts, build order, account discovery, and which skill to use |
| configuring-connections | Credentials, auth methods, OAuth, iClients |
| configuring-exports | Data source steps -- REST, SOAP, database, file, webhook, delta sync |
| configuring-imports | Data destination steps -- mappings, lookups, upsert logic |
| building-flows | Pipelines wiring exports to imports -- scheduling, chaining, error management |
| building-apis | Custom HTTP endpoints for synchronous external access |
| building-tools | Reusable operations callable from flows, APIs, agents, and MCP servers |
| building-mcp-servers | MCP endpoints exposing tools to external AI agents |
| building-b2b | EDI integrations -- trading partners, X12/EDIFACT, file definitions |
| configuring-ai-agents | LLM-powered import steps (OpenAI, Gemini) and guardrails |
| configuring-filters | Expression and script filters on exports, imports, and branches |
| configuring-guardrails | PII detection, content moderation, AI-based validation |
| configuring-lookup-caches | In-memory key-value stores for fast lookups and dedup |
| managing-users | User invitations, permissions, MFA/SSO, access levels |
| managing-integrations | Integration containers, cloning, and lifecycle management (ILM) across environments |
| managing-api-tokens | Inbound API tokens -- scoping, rotation, revoke/delete lifecycle |
| managing-stacks | Bring-your-own compute for hooks and connector wrappers (server or AWS Lambda) |
| managing-on-premise-agents | Secure connectivity to private systems behind a firewall |
| using-marketplace-templates | Install Templates and Integration Apps; copy prebuilt flows |
| troubleshooting-flows | Diagnosing failures, partial errors, stuck jobs, empty runs |
| writing-mappings | Mapper 2.0, Transformation 2.0, lookups, response mapping |
| writing-handlebars | Dynamic template expressions for mappings, URIs, SQL, filters |
| writing-scripts | JavaScript hooks -- preSavePage, preMap, postMap, postSubmit |
| writing-sql | SQL for RDBMS exports/imports across Snowflake, Postgres, MySQL, and more |
Slash Commands
The plugin bundles slash commands for Cursor and Claude Code -- skills-backed authoring helpers that work without a connected account:
| Command | Description |
|---|---|
/celigo-plan-integration | Plan a new integration from requirements (design + build order) |
/celigo-handlebars | Author or debug a Handlebars expression |
/celigo-sql | Write SQL for an RDBMS export/import |
/celigo-mapping | Build a field mapping (Mapper 2.0) |
/celigo-review-config | Review a pasted resource config against best practices |
MCP Prompts & Resources
The mcp/ directory contains prompts and resources served by the Celigo MCP server via the MCP protocol's prompts/list, prompts/get, resources/list, and resources/read endpoints.
Prompts
| Prompt | Description |
|---|---|
| getting-started | Orientation for the Celigo MCP server -- core concepts, build order, tool inventory |
| plan-new-integration | Plan a new integration from requirements |
| review-flow-config | Review an existing flow configuration |
| troubleshoot-flow | Diagnose a failing or misbehaving flow |
| diagnose-connection | Troubleshoot connection issues |
| audit-account-health | Audit account health and find issues |
| writing-handlebars | Write Handlebars template expressions |
| writing-sql | Write SQL for RDBMS exports and imports |
Resources
| Resource | URI |
|---|---|
| Account Architecture Model | celigo://resources/account-architecture |
| Account Settings Reference | celigo://resources/account-settings |
| API Reference | celigo://resources/api-reference |
| Connector Catalog | celigo://resources/connector-catalog |
| Error Patterns | celigo://resources/error-patterns |
| Glossary | celigo://resources/glossary |
| Handlebars Helper Catalog | celigo://resources/handlebars-helpers |
| Recycle Bin Reference | celigo://resources/recycle-bin |
| Tool Usage Guide | celigo://resources/tool-usage-guide |
Adding MCP content
See the MCP README for the frontmatter schema and how the Celigo MCP server consumes these files.
Celigo CLI
The skills reference the Celigo CLI for examples. Install it with:
API and UI alternatives are noted where applicable.