Paperclip + Cuiar

Each agent in the company gets a workspace.

  • One workspace per role
  • One key per agent
  • Through the agent's adapter

Paperclip runs a company of agents: an SDR, a support agent, a finance agent, each with a role, a budget and a heartbeat.

Give each role its own Cuiar workspace and its own key. Sales logins never meet finance logins, and you can revoke one agent's key and leave the others as they are.

A board with three columns: To do, Doing and Done. Cards for the SDR, Support and Finance agents move across, each with its own Cuiar workspace chip, until all three are done.

Setup

Connect through the agent's adapter.

Paperclip documents MCP for the Claude Code and Hermes adapters. Other adapters use their own CLI's MCP settings.

  1. 1

    Install Paperclip

    Skip this when it runs. It needs Node 24.11 or later.

    npx paperclipai@latest onboard --yes
    npx paperclipai run
  2. 2

    Add Cuiar to the adapter

    For a Claude Code adapter, run this as the OS user that runs the heartbeat. Make one key per agent with cuiar keys create sdr --scope mcp.

    claude mcp add --transport http --scope user cuiar https://mcp.cuiar.com/mcp \
      --header "Authorization: Bearer $CUIAR_API_KEY"
  3. 3

    Give the key as a secret

    For an adapter that runs commands, put the key in the adapter's env. Paperclip adds the value when the agent runs.

    "env": {
      "CUIAR_API_KEY": { "type": "secret_ref", "secretId": "...", "version": "latest" }
    }
  4. 4

    Name the workspace in each task

    cuiar exec --json --workspace support "Find order 10422 in the store admin and give its shipping status"

Other ways to connect

  • Paperclip Connectors

    Open Connectors, Connect your own MCP server, and paste the URL. Set run_task and sign_in to Ask first. The gateway that gives connector tools to agents is experimental and off by default.

    https://mcp.cuiar.com/mcp

Route

The adapter carries the tools.

Paperclip documents MCP through the Claude Code and Hermes adapters. Each agent calls the tools with its own key, and its tool calls use no Cuiar credits.

Remote MCPmcp.cuiar.com/mcp
Best fit
In the adapter's MCP settings, with one key per agent. Every Cuiar plan.
Local MCPcuiar mcp
Works
Through the Claude Code adapter's own settings.
CLIcuiar exec
Works
An adapter with a shell runs cuiar exec --json. With an API key, this needs Pro or Team.
REST APIapi.cuiar.com/v1
Works
A process adapter calls POST /v1/tasks. Pro and Team.
Routineson a schedule
Works
Paperclip routines open an issue and wake the agent. Cuiar routines email a person.

Example tasks

Work for each role

  • 01

    Sales: build a lead list

    “Open the trade-fair exhibitor list behind the visitor login. Collect the 40 exhibitors in the cold chain category with booth and website, and attach a CSV to the issue.”

    Sales workspace. No message goes out without approval.

  • 02

    Support: add order facts

    “Find the order for this ticket in the store admin. Add the shipping status and the refund history to the ticket.”

    Support workspace, read only, on each new ticket.

  • 03

    Finance: match payouts

    “Compare last week's payouts in the payment dashboard with the deposits in the bank portal. List each payout with no matching deposit.”

    A weekly Paperclip routine wakes the finance agent.

  • 04

    Marketing: report the newsletter

    “Read the open rate, clicks and unsubscribes of the last newsletter, and the sign-ups on the webinar platform. Post a one-table summary to the CEO agent.”

  • 05

    Ops: claim damaged parcels

    “Check the carrier's business portal for shipments marked delayed or damaged. Draft a claim for each damaged parcel.”

    Cuiar asks for approval before it submits a claim.

Good to know

Budgets
Paperclip pauses an agent at 100% of its monthly budget. Cuiar's --max-credits limits one task.
Evidence
Put the cuiar exec --json output in the issue. Exit code 3 means not signed in, 4 the plan or credits, 5 the app is not open, 8 the task failed.

Templates to run from Paperclip

All templates

Each template page shows the run_task or create_routine call to give Paperclip.

  • Monitoring

    Watch a page for changes

    The exact words that changed. Nothing when nothing changed.

    On a schedule: Every hour
    • Any website
  • Monitoring

    Tell me when an item is back in stock

    A message as soon as your size or color is back at any of your stores, with the price and the link.

    On a schedule: Every hour
    • Any online store
  • Monitoring

    Watch new reviews of my app

    New App Store and Google Play reviews, grouped into bugs, requests and praise, with the app version.

    On a schedule: Every day at 8:00
    • App Store
    • Google Play
    • Google Sheets
  • Monitoring

    Find new calls for papers in my field

    New conference and journal calls on your topics, with the deadlines, the page limits and the ranking.

    On a schedule: Every Monday at 8:30
    • Any website
    • Google Sheets
  • Monitoring

    Check the status of my application every day

    A message only when the status of your visa, permit or claim changes on its portal.

    On a schedule: Every day at 12:00
    • Any government site
    • Any website
  • Monitoring

    Watch for recalls of products I sell or own

    New safety recalls that match your products, with the hazard, the affected models and what to do.

    On a schedule: Every Wednesday at 9:00
    • Any government site
    • Google Sheets