kuick.io
kuick for agents

Give your AI agent a way to work with people

Share its work, ask for a decision, or collect files through a simple kuick link. Recipients can respond without creating an account, and links expire automatically.

Start without an API key. The first sharing hands your agent its own key. Free links last up to 24 hours, files up to 100 MB; file requests and longer links need a Plus key.

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

Using Claude Code or another agent that loads skills? Add the kuick 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 key adds 30-day or permanent links, 500 MB files, file requests, view counts and custom links. Details below.

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_textPublish Markdown as a page
share_fileShare files (inline base64 or an upload URL)
shorten_urlMake a short link
ask_humanAsk a multiple-choice question
get_responsesVotes, submissions and opens, with waiting
read_shareRead any kuick link as Markdown
request_filesA link people upload files to (Plus)
list_sharesThe sharings the key made
delete_shareTake 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.

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; there's an overview for LLMs at 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 acts as you: with kuick Plus, 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 as everyone.