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

npx skills add celigo/ai

Install specific skills

# List available skills
npx skills add celigo/ai --list

# Install one skill
npx skills add celigo/ai --skill getting-started

# Install to a specific agent
npx skills add celigo/ai --skill configuring-exports -a claude-code

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:

/plugin marketplace add celigo/ai
/plugin install celigo@celigo

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:

npm install -g celigo-cli

API and UI alternatives are noted where applicable.

Links

• Celigo Documentation
• Celigo Developer Guide
• Agent Skills Specification
• Skills Directory

License

MIT