Skip to content

celigo/ai

Repository files navigation

Celigo AI

One-stop shop for building integrations on the Celigo platform with AI.

skills.sh

This repo contains:

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.

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

License

MIT

About

Domain knowledge and tools for building Celigo integrations with AI coding assistants.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors