Quickstart

Build with Clay from your coding agent, or call the Clay API from your own applications.

There are two ways to use Clay as a developer: install the agent plugin to build with Clay inside your coding agent, or call the Public API directly from your own applications and services.

Agent plugin

The agent plugin gives your coding agent Clay’s skills, MCP tools, and the clay CLI — the fastest way to build with Clay from any coding agent.

Copy this into your agent of choice and let it install and set up the plugin for you:

Install the Clay plugin by following the steps in
https://github.com/clay-run/agent-plugins/blob/main/GETTING_STARTED.md

Agent plugin repository

Manual install and setup instructions for Claude Code, Codex, and Cursor.

API

Use the Public API to call Clay from your own applications and services — backend jobs, internal tools, queues, and product features. Requests authenticate with a Clay API key in the clay-api-key header.

API reference

Endpoint paths, request bodies, response schemas, and an interactive try-it console.

Get an API key

You can create an API key two ways:

• Ask your agent to generate one for you after installing the agent plugin.
• Create one yourself in Clay under Settings → Account → API keys (beta).

Keep keys server-side. Do not expose them in browser code, mobile apps, public repositories, logs, or analytics tools. See Authentication for details.