Kong AI Marketplace

Portable Kong skills plus kong-konnect MCP configuration for Cursor, Claude Code, and shared skill installers.

This repo is the contributor-facing source of truth for the packaged skills and install metadata. End users normally consume these assets through marketplace catalogs, plugin bundles, or shared-skill installers rather than by reading this repo directly.

Tech Preview

This repository is currently in tech preview. It is actively maintained and updated as the shipped skills, install surfaces, and packaging workflows evolve.

Public issues are welcome during tech preview. Pull requests are currently limited to Kong employees while the preview is in progress.

The repo now uses a plugin-first layout. Root marketplace manifests advertise installable plugin packages, and the first shipped package is plugins/kong-konnect/.

Getting Started

• Installation docs: docs/install/README.md
• Available skills: docs/skills.md
• Contributing: CONTRIBUTING.md
• Developer guide: docs/developer.md
• Release process: docs/release.md
• Testing guide: docs/testing.md
• Security policy: SECURITY.md
• Repo structure: docs/structure.md

Contributing

Contributor bootstrap and maintenance guidance lives in CONTRIBUTING.md.

Recommended local validation path for contributors:

mise trust
mise install
mise run preflight
mise run deps
mise run hooks:install
mise run lint

The repo hooks are an opt-in local guardrail. GitHub Actions remains the enforcement path on pull requests and pushes to main.

Install Targets

Authentication

All install surfaces use the same bearer token model:

Authorization: Bearer ${KONNECT_TOKEN}

KONNECT_TOKEN is only needed when you install or use the kong-konnect MCP server through a plugin wrapper or manual MCP setup. A skill-only install via npx skills or gh skill does not require it.

Skill Install Notes

• Install the whole repo with npx skills add kong/ai-marketplace.
• Install one skill with npx skills add kong/ai-marketplace --skill gateway-plugin-datakit.
• Update one installed skill with npx skills update -g -y gateway-plugin-datakit or gh skill update gateway-plugin-datakit.
• Prefer native plugin update flows in supported host tools over custom startup hooks.
• Be careful with any automatic update path: it can pull newer skill instructions automatically and may introduce supply-chain or security risk.
• For gh skill, preview before install with gh skill preview kong/ai-marketplace gateway-plugin-datakit.

Use plugins/kong-konnect/mcp.json as the shared checked-in reference shape for the kong-konnect MCP server.