# kuick for AI agents: MCP server, CLI and API | kuick.io

> Let your AI agent share reports and files as links, send one-time secrets, ask people questions and wait for the answer. MCP server, CLI and HTTP API; no sign-up needed.

Source: https://kuick.io/agents

---

## Four jobs your agent can hand to kuick

### Get approval before your agent acts

Your agent shares a plan or a change and asks for a decision before it goes ahead.

People see

A one-question poll they answer with a tap, no account needed.

Agent gets

The vote as soon as it's cast, by waiting on the link or through a webhook.

### Collect files from peoplePlus

Your agent asks for the document or file it's missing, through one upload link.

People see

An upload page that takes their files and a short note.

Agent gets

Each submission as it arrives, with a download URL per file.

### Share work that's ready to review

A report, research notes or any output becomes a tidy page on its own link.

People see

Markdown rendered as a real page, or the files, on any device.

Agent gets

The link to send on, which it can take down early; with Plus, a view count too.

### Pass sensitive information securely

API keys and passwords go in a one-time link, with an optional passcode, never in plain chat.

People see

The secret once. The first open deletes it.

Agent gets

Confirmation that the link was opened and is gone.

## Connect your agent in a minute

[MCP server — One line in Claude Code, Cursor or VS Code and the agent can share, ask and read links.](#mcp)[CLI — For agents with a shell and for people: share, secret, ask and read from the terminal.](#cli)[HTTP API — One call per sharing, with long polling or signed webhooks for the answers.](#api)

Using Claude Code or another agent that loads skills? Add the [kuick skill](#skill) so it knows when to reach for a link.

## Safe to hand to people

Can people respond without an account?

Yes. Recipients open the page, vote or upload straight from the link, on any device.

When does a link expire?

When the agent says: 5 minutes to 24 hours on the free plan (24 hours by default, secrets 1 hour), up to 30 days or never with Plus. The agent can also take a link down early.

How is sensitive content protected?

Secrets go in one-time links that delete themselves on the first open, optionally behind a passcode, and the agent can check that it was read.

How does the agent get responses?

It waits on the link (up to 55 seconds per call) for the next vote, upload or open, or gives a `webhookUrl` and gets a signed POST for each one.

What's free, and what does Plus add?

Free, with no key: Markdown pages, files up to 100 MB, polls, secrets and short links. A [Plus](https://kuick.io/pricing) key adds 30-day or permanent links, 500 MB files, file requests, view counts and custom links. [Details below](#keys).

## Reference

## MCP server

Remote, over Streamable HTTP. Works without a key: the first sharing returns an anonymous one the agent keeps for follow-ups.

Claude Code

claude mcp add --transport http kuick https://mcp.kuick.io/mcp

Cursor, Claude Desktop, VS Code and other clients

{
  "mcpServers": {
    "kuick": {
      "type": "http",
      "url": "https://mcp.kuick.io/mcp"
    }
  }
}

With an account key, for Plus features

{
  "mcpServers": {
    "kuick": {
      "type": "http",
      "url": "https://mcp.kuick.io/mcp",
      "headers": {
        "Authorization": "Bearer kuick_…"
      }
    }
  }
}

| share\_text    | Publish Markdown as a page                   |
| -------------- | -------------------------------------------- |
| share\_file    | Share files (inline base64 or an upload URL) |
| shorten\_url   | Make a short link                            |
| ask\_human     | Ask a multiple-choice question               |
| get\_responses | Votes, submissions and opens, with waiting   |
| read\_share    | Read any kuick link as Markdown              |
| request\_files | A link people upload files to (Plus)         |
| list\_shares   | The sharings the key made                    |
| delete\_share  | Take a link down now                         |

## CLI

For agents with a shell (Claude Code, Codex, Aider) and for people. Needs Node 18 or later; it keeps its key in `~/.config/kuick`.

npx -y kuickio@latest share report.md          # Markdown becomes a page
npx -y kuickio@latest share chart.png data.csv # files behind one link
npx -y kuickio@latest secret "sk-live-…"       # one-time: gone after the first open
npx -y kuickio@latest ask "Ship it?" Yes No --wait 300
npx -y kuickio@latest read https://kuick.io/ab12cd

Every command takes `--expires 2h`, `--once`, `--passcode`, `--title` and `--json`. `kuick login` stores an account key.

## HTTP API

One call per sharing: `text` (Markdown), `file`, `link`, `poll` or `file_request`. A file sharing returns a signed URL to PUT each file to.

curl -s https://backend-api.kuick.io/v1/agent/shares \
  -H 'content-type: application/json' \
  -d '{"type":"text","markdown":"# Report\n\nAll green.","expiresIn":"2h"}'

# → {"url":"https://kuick.io/ab12cd","expiresAt":"…","key":"kuick_…"}

- `GET /v1/agent/shares/<code>?wait=55&since=0` waits for the next vote, submission or open.
- `webhookUrl` on any sharing gets a signed POST for each of them (`X-Kuick-Signature`: HMAC-SHA256 of the body with the returned `webhookSecret`).
- Everything else is in the [OpenAPI document](https://backend-api.kuick.io/v1/openapi.json).

## Skill

A `SKILL.md` that tells an agent when kuick helps and how to call it, for Claude Code and other agents that load skills.

mkdir -p ~/.claude/skills/kuick
curl -s https://kuick.io/skill.md -o ~/.claude/skills/kuick/SKILL.md

Or `npx -y kuickio@latest install-skill`. Read it at [kuick.io/skill](https://kuick.io/skill); there's an overview for LLMs at [kuick.io/llms.txt](https://kuick.io/llms.txt).

## Reading links

Add `.md` to any kuick link, or ask for it with `Accept: text/markdown`, and the sharing comes back as Markdown with its details up front (`.json` works too). Links with a passcode or a one-time open stay closed until an agent opens them with `read_share`.

curl -s https://kuick.io/ab12cd.md

## Keys & plans

Without a key, an agent shares on the free plan: links for up to 24 hours, files up to 100 MB, passcodes and one-time links. A key from your [account](https://kuick.io/account?tab=api-keys) acts as you: with [kuick Plus](https://kuick.io/pricing), links last up to 30 days or forever, files go up to 500 MB, and file requests, view logs and custom links open up. Everything the key shares shows up on your dashboard.

 Agents follow the same [terms of use](https://kuick.io/policies/terms-of-use) as everyone.
