How to connect Keiki MCP to Claude

Connect Claude Web, Desktop and Cowork to Keiki MCP. Create a keiki agent for customer support, review keiki conversation evaluation results, and more using natural language, with authentication handled for you.

Keiki MCP logoKeiki MCP
Dcr Oauth

Keiki MCP is a hosted service for building and managing Keiki agents, conversations, evaluations, and channels. It centralizes agent operations, billing, integrations, and organization settings in one MCP interface.

336 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Keiki account to Claude via Composio Connect, enabling it to create a Keiki agent for customer support, review Keiki conversation evaluation results, update Keiki organization billing settings, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Keiki MCP with

Connecting Keiki to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Keiki account

Back in Claude, ask it to connect to Keiki or give it any Keiki-related task.

For example, ask Claude to:

  • "Create a Keiki agent for customer support"
  • "Review Keiki conversation evaluation results"
  • "Update Keiki organization billing settings"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Keiki account is ready to use.

What is the Keiki Claude Connector, and what's possible with it?

The Keiki MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Keiki account. It provides structured and secure access to agent deployments, conversations, connected channels, organization settings, and platform jobs, so your agent can deploy agents, manage connected resources, inspect work in progress, and handle organization administration on your behalf.

  • Agent deployment management: Have your agent create or update Keiki agent deployments and check the goals those agents have produced.
  • Conversation and channel control: Let the agent delete conversation history, end human takeovers, unblock identities, and remove contact cards when needed.
  • Connected resource administration: Direct your agent to remove agent capabilities, tools, scheduled loops, MCP presets, phone lines, webhooks, and deployment connections.
  • Organization settings and access: Instruct your agent to manage members, invitations, SSO settings, organization MCP integrations, provider accounts, secrets, payments, and connected identities.
  • Job monitoring and platform support: Have your agent check or cancel long-running jobs and file bug reports or feature requests with the Keiki engineering team.

Troubleshooting

1. Why does Claude not use the Composio connector for Keiki?

The connector can show as connected, but Claude must use it in each Keiki conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Keiki again.

2. Why does Claude show an MCP server error before Keiki connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Keiki.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Keiki.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Keiki authorization link not work?

The Composio connector is one server. Your Keiki account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Keiki connection.
  • Composio creates a fresh Keiki authorization link.
  • Open that link in your browser and finish the Keiki sign-in.

4. Why do Keiki actions fail after they worked before?

The Keiki connection can expire or lose permission.

  • Ask Claude to inspect the Keiki connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Keiki account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Keiki.
  • If the action still fails with a permission error, check that the connected account has that permission in Keiki itself.

5. How do I switch to a different Keiki account?

Claude can manage the Keiki connection for you.

  • Ask Claude to disconnect or delete the current Keiki account.
  • Ask Claude to connect Keiki again.
  • Open the new Composio authorization link for Keiki.
  • Sign in with the other Keiki account in the browser.
  • After the account connects, ask Claude to retry the Keiki task.

6. Why is my Keiki connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Keiki connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Keiki tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Keiki.
TOOLS

Supported Tools

Every Keiki MCP action and event your agent gets out of the box.

Cancel job

Stop a job started by a long call, and ask the work behind it to stop too.

Check job

Read a job that a long call handed back instead of a result: its status, the text and tool calls it has produced so far, and its final result once it has finished.

Current context

Who this token acts as, which organization it is bound to, and the current time.

Delete agent groups by id

Delete an agent group, so its members can no longer ask each other through it.

Delete agents by id

Delete an agent with its tools, alerts, loops and configuration, releasing its Keiki VM if it has one.

Delete agents capabilities by slug

Uninstall a capability from an agent, dropping its version pin.

Delete agents identity webhook

Remove sender identity checks; returns { ok }.

Delete agents lines by number

Remove a phone line from an agent; the agent stops receiving on it.

Delete agents loops by loop id

Delete one of the agent’s scheduled loops for good: its schedule stops and its run history is removed.

Delete agents mcp presets by preset id

Disconnect an MCP preset from the agent and remove it from its daemon.

Delete agents tools by tool id

Delete an authored tool.

Delete agents wallet intents by intent id

Revoke a purchase: cancels its payment credential so it can no longer be charged, and returns the updated purchase.

Delete conversations block

Unblock one identity for this conversation’s agent so its messages trigger replies again.

Delete conversations contact card

Clear the dynamic contact card for this conversation.

Delete conversations history

Permanently delete one agent’s stored message history with an identity and return how many messages were cleared.

Delete conversations takeover

End a human takeover early and hand the conversation back to the agent, including any hold taken from a Slack thread.

Delete deployment

Delete one deployment and release its connected channels.

Delete evals cases by id

Delete an organization eval case permanently, not just archive it.

Delete identities by id

Delete an identity: tears down its inbound routing and deactivates it, so the channel stops answering.

Delete identities slack installs by install id

Stop answering in one workspace that installed this Slack identity, without touching the app or its other workspaces — the workspace keeps the app in Slack; only its stored token is dropped.

Delete identities slack operators by slack user id

Remove one Slack user from a Slack identity’s operator allowlist.

Delete identities slack teams by team id

Stop routing one customer Slack workspace to its agent.

Delete identities teams installs by install id

Forget one tenant’s install of a Teams identity so the agent stops answering there.

Delete invitations by id

Revoke a pending invitation so its link no longer works.

Delete mcp clients by token id

Revoke this user’s organization OAuth connection; returns { ok }.

Delete members by id

Remove a member from the organization.

Delete org mcp integrations by id

Stop sharing an org MCP integration, removing it from every agent it was granted to.

Delete payments

Disconnect payments; returns { ok }.

Delete payments payees by id

Delete a payee; returns { ok }.

Delete provider accounts by id

Disconnect one of the organization’s own Photon accounts.

Delete sandbox scripts by id

Delete a sandbox script; agents it is attached to stop running it.

Delete secrets by name

Delete a secret and its bound mirrors; returns { ok, name }.

Delete skills by id

Delete a skill or document; agents using it lose it.

Delete sso

Disable SSO; returns { ok }.

Delete sso domains by id

Remove an SSO domain; returns { ok }.

Delete trace exporters by id

Delete a destination and its agent attachments.

Delete webhooks by id

Delete a webhook endpoint.

Deploy agent

Create or update an agent deployment using the body format of POST /api/v1/developer/deployments.

Escalate

File a bug report or feature request about the Keiki platform itself with the engineering team.

Get agent goals

The outcome kinds each agent has produced and whether any carry money — what an agent’s CRM columns stand for.

Get agent groups

List the organization’s agent groups — which agents may ask each other with ask_agent — with each group’s name, description and members (agent, description, hub or spoke role).

Get agent groups activity

Every agent group’s running peer threads and live roster in one read — the way to answer how all the groups (swarms) are doing at once.

Get agent groups note

The group’s shared note — what its agents have settled among themselves (decisions, who does what, findings) — with its revision, last author and update time.

Get agent groups note versions

History of the group note, newest first: one entry per saved version, with the sha to fetch it by.

Get agent groups note versions by sha

The group note body as it was at one historical version (a sha from the versions list).

Get agent groups roster

Live roster of one group: per member its status (running, waiting, idle, ended), running turns, pending asks, background tasks and 24h tokens and cost, plus totals.

Get agent groups threads

The asker→peer threads currently live among one group’s members (who is asking whom right now).

Get agentmail domains

Custom email domains the organization added for agent inboxes, each with its region and live DNS verification state from AgentMail.

Get agents

List every agent in the organization with its status, model and channels.

Get agents a2a

Whether other vendors’ agents can call the agent over A2A, with its Agent Card URL and JSON-RPC endpoint.

Get agents actions

List the agent’s persisted approval actions (tool calls waiting on, or past, a human decision), newest first, with their status, arguments and group id.

Get agents analytics

Engagement for one agent over a date range: contact and agent response times, received/sent message breakdowns such as where contacts write from (null when event analytics is not configured), and public profile visits.

Get agents api gateway

Whether the agent answers on the OpenAI/Anthropic-compatible API and in passthrough mode, with the base URLs and the model name a client sends.

Get agents by id

Agent detail: its configuration and features, line routing status, harness, template version, tools, attached skills, its 50 most recent conversations, and connection issues to fix.

Get agents capabilities

List the marketplace capabilities installed on an agent, including disabled ones, with each pinned version, how it was installed, any newer version available, and declared secrets the org has not set yet.

Get agents conversations

Every conversation one agent is having, newest first — who it is talking to, the last message, message count, whether the thread is active and whether it has errors.

Get agents conversations by phone

One conversation thread between the agent and a contact (`phone` is their phone number, email or tg: identity, URL-encoded): its metadata, messages and the trace spans of the turns that produced them.

Get agents conversations sentiment

One conversation’s mood per user turn, oldest first (0 angry to 4 delighted; unclassified turns have no score), with drop/recovery shifts, the reply that caused each shift and why, and the signals on each turn.

Get agents edit

The agent form payload: the full editable config (name, model, systemPrompt, features, escalationRoutes, skillIds, sandboxScriptIds, sandboxEnvSecrets, execPolicy, userSecrets, responseSchemaOverlay, updatedAt) plus the org’s lines.

Get agents evals channel preview

Preview a real-channel eval run per hosted driver (imessage, email, x): whether it is available and why not, the handle it would message, and the eligible and excluded cases — plus any active run and the last run.

Get agents executor

Resolve the agent’s Executor.

Get agents fine tune

Read fine-tune readiness for the agent’s current version: graded conversation counts, progress toward the kickoff threshold, whether the caller may start one, and any request already on file.

Get agents harness status

Report what runs the agent and whether it is connected: the platform harness, a self-hosted Hermes relay or dispatch URL (with why it is waiting), or a Maritime Keiki VM and its state.

Get agents loops

List the scheduled loops attached to an agent with their schedule and state.

Get agents loops runs

Read a loop’s recent runs, newest first, from a bounded retention window: status (the platform’s turn and tool-health view), timings, error, trace id and detail.

Get agents mcp presets tools

The tools a connected MCP exposes, read live from the daemon, each with the permission (allow/ask/deny) in force, plus the default permission and every stored per-tool choice.

Get agents note

Read the agent’s working note — the durable scratchpad it rewrites while it works — with its revision.

Get agents note versions

List the working note’s version history, newest first, with the sha of each version.

Get agents note versions by sha

Read the working note body as it was at one version sha from the history.

Get agents public profile

Whether the agent’s public profile page is published, its URL slug and tagline, and whether the caller may change it.

Get agents quality

Turn-quality review for one agent: review stats, its review settings, and the prompt or model fixes the reviewer drafted (state, summary, rationale, proposed prompt/model, score before and after).

Get agents rollouts

Read the agent’s open staged rollout (mode, percent of conversations on the staged config, the staged config itself) and its recent ended rollouts.

Get agents sandbox script runs

The latest 50 runs of the agent’s sandbox scripts, newest first — status, exit code and output tails.

Get agents shared line

The shared iMessage number and join code contacts text to reach this agent.

Get agents signals

Built-in quality signals for one agent over a date range: each signal’s events, share of classified users and change against the previous period of the same length, plus average mood (0 angry to 4 delighted) and the biggest mood drops with the judge’s reason.

Get agents signals events

The turns one signal (`key`, as returned by the signals summary) fired on, newest first: phone, trace id, source, mood and shift.

Get agents user connections

List the personal provider definitions declared on the agent — services each conversation user authorizes with their own account.

Get agents versions

List the agent configuration’s version history, with the sha of each version.

Get agents versions by sha

Read the agent configuration snapshot saved at one version sha.

Get agents wallet

The agent’s wallet: spending policy, connection state, spend so far, pending purchase approvals and history — or null when it has none — plus the payment programme, default policy, and whether the caller may manage it.

Get agents wallet payment methods

Labelled payment methods on the wallet’s connected account (never card numbers), for choosing `paymentMethodId`.

Get agent templates

Complete agent templates the platform can provision in one call (e.

Get audit

List audit events as { events, nextCursor }; filter by cursor, limit, actor, action, target_type, target_id, from, to.

Get audit verify

Verify the organization audit hash chain and return its verification result.

Get auto

Read whether the organization’s plan allows Auto mode and which front and worker models it uses.

Get axiom traces

Spans read from the OTLP collector — kept past the 14-day window of /traces, and alongside spans other services exported under the same trace.

Get billing

Read the organization’s billing overview: available phone lines, usage, customer plan details, upcoming invoice and default plan id.

Get billing activity

List the organization’s invoice and platform credit grant activity, newest first.

Get billing auto top up

Read the organization’s auto top-up settings: enabled, threshold, quantity, whether it is available on the plan, whether a payment method is saved, and the last failed top-up if any.

Get billing capability pricing

Read the default plan’s per-capability billing metadata, included amounts, units and price labels.

Get billing capability usage by agent

Read local capability usage grouped by feature and agent for each feature’s latest recorded billing period, including unattributed and deleted-agent buckets.

Get billing consumer pricing

Read public consumer plans, add-ons and feature pricing metadata from the billing catalog.

Get billing included allowance

Read public default-plan included token-credit allowances without customer data.

Get billing plans

List the organization’s available non-add-on, non-archived plans with display prices, features, trial information and current/scheduled flags.

Get billing portal

Create a Stripe billing portal link for the organization.

Get billing pricing account

Read the connected organization’s current plan and status, usage and credit access checks.

Get billing public plans

Read public recurring plans with included limits and platform credit conversion rates for comparing options.

Get billing service spend

Read the organization’s recorded customer service charges for the billing period.

Get billing status

Check the organization’s lightweight plan gate rather than loading its billing overview.

Get billing usage by conversation

List up to 100 conversations with the most recorded token usage across the organization’s active developer configurations, excluding playground and copilot traffic.

Get blog

Keiki's own blog, newest first: each post's slug, title, category (Changelog, Product, Announcements), publish date, summary and URL.

Get blog by slug

One Keiki blog post in full: its title, category, date and summary, plus the whole post as `markdown`.

Get capability tools

Every platform capability offered on this deployment and the tools each adds to an agent that enables it, as feature, tool name and tool description.

Get channel access requests

List organization early-access requests as { requests }.

Get conversations

One page of the organization’s conversations, most recent first, each with its agent, identity and latest state; with q, a full-text search of message content returning matching conversations with snippets.

Get conversations by phone

One conversation thread by identity (phone number, email, or prefixed id like tg:123): its messages with their trace spans, the agent, blocked and takeover state, whether a turn is running, background tasks, and the peer for inter-agent threads.

Get conversations contact card

Read the contact card set specifically for this conversation, and whether dynamic contact cards are available.

Get conversations count

How many conversations match the same filters as the conversation list, and how many of those need a person: { all, needsReview }.

Get dashboard

Home-page summary for the signed-in user: their name, email, role and orgs (with the active one), headline stats (active conversations, messages today, average response time, total turns) and every agent in the org.

Get deployment

Read one deployment in the current organization.

Get evals cases

List the organization agent’s persisted eval cases, including generated, user-authored and regression cases.

Get evals cases versions

Read the generated eval suite’s version history for an agent in the organization.

Get evals diffs

Compare two organization eval runs as their results arrive.

Get evals runs by id

Read one organization eval run’s status, candidates, rankings and per-case results with trace ids.

Get evals runs cases

Read the full persisted case records referenced by an organization eval run, including archived cases.

Get evals runs latest

Read the agent’s latest eval run, optionally limited to single-model, sweep or real-channel runs.

Get evals runs transcript

Read an organization real-channel eval run’s recorded message transcript.

Get evals suggestions

Find behaviors worth testing from the agent’s recorded production traffic in the chosen window, with trace counts, error rates, models and existing suite coverage.

Get identities

List the org’s active messaging identities — SMS lines, Telegram, WhatsApp, Slack, Teams, X and AgentMail — with the agent each is attached to and its routing status.

Get identities phone calls forwardable lines

List the agent's iMessage lines and whether each can forward its calls: `{ lines: [{ number, support, connected }] }`.

Get identities phone calls numbers

Search Telnyx for available US local voice numbers in an area code or state, or anywhere in the US when neither is given.

Get identities phone calls voices

List the ElevenLabs voices a phone line can use: `{ voices: [{ id, name, description, previewUrl, labels }] }`.

Get identities slack channels

Per workspace that installed this Slack identity, the channels its bot is already in — the channel ids an escalation route may name — plus the scopes the install is missing, or an error when its token cannot list channels.

Get identities slack manifest

Build the Slack app manifest for a new identity and a prefilled api.

Get identities slack operators

List the Slack users allowed to press this identity’s consequential buttons — taking a conversation over, replying to a customer, running an offered action.

Get identities slack signing probe by probe id

Check a Slack signing-secret probe: pending until a signed event from Slack arrives, then proven or failed.

Get identities slack teams

For a Slack app that routes customer workspaces to different agents, list each workspace: its team id, the bound agent (or null), whether the app is installed there, and when it was last messaged while unbound.

Get identities teams manifest

The Teams app manifest for a connected Teams identity — it names that identity’s Microsoft App ID.

Get identities teams setup

Return the messaging endpoint an Azure Bot registration must point at before a Teams identity can be connected.

Get identities whatsapp kapso available

Read platform Kapso configuration as { available }.

Get identities x oauth available

Whether “Log in with X” can be offered — an X OAuth client is configured — plus which app-level credentials the platform already has, the redirect URI to register on the X app, and the hosted eval driver’s handle when one exists.

Get identities x oauth callback

The redirect X sends the user back to after authorizing.

Get identities x oauth status

Poll a started X login: returns the authorization’s status and, once complete, the X account it resolved to — the input the connect call needs as `oauthState`.

Get insights

Org analytics over a date range: daily activity, totals (messages, conversations, turns, errors, tokens, average latency), turns and messages per agent, task outcomes and response times.

Get invitations

List the organization’s invitations, newest first, with email, role, status (pending, accepted or revoked) and expiry.

Get keys

List the organization’s API keys: name, prefix (never the full secret), scopes, bound agent, and last-used, expiry, revocation and creation times.

Get keys usage

Daily usage of one API key, aggregated by day, by route and method, and by agent, with accepted vs rejected (revoked/expired) counts and first/last seen times.

Get lines

List the organization’s phone lines with channel, line type, routing status and message, activation time, and the agent each is assigned to.

Get lines contact card

Read the contact card iMessage shows for a line — first and last name, photo URL, and whether the provider has applied it — straight from the line’s provider, plus the line’s channel.

Get lines price

The display price of a new iMessage line (`price`, e.

Get lines providers

Status of each iMessage line provider (Photon, Linq, Blooio) as shown on the status page: today’s `state`, reachability, last check, 90-day uptime and daily history.

Get lines provisioning by id

Progress of one of the organization’s line purchases: `status` (pending, provisioning, action_required, requested, completed or error), the `phoneNumber` once ready, the Blooio `actionUrl` when the purchase needs completing, or the `error`.

Get live snapshot

What the org’s agents are doing right now: the agents, turns from the last five minutes plus any still running with their steps, outcomes and new people from the last half hour, and today’s numbers.

Get loops

List the organization’s scheduled loops, newest first: agent, the person it runs for, schedule, enabled and auto-paused state, last status and error, last and next run, and run count.

Get marketplace capabilities

Browse published (reviewed) marketplace capabilities, one listing per capability with its newest version and the other versions available to pin, plus whether the caller is a capability reviewer.

Get marketplace mine

List the capabilities this organization has published itself, in every review state (draft, pending review, published, rejected).

Get marketplace reviews

List the capabilities awaiting publication review.

Get mcp brand lookup

Resolve the brand behind an MCP server endpoint URL — its name, domain, description and logo.

Get mcp catalog

Search the approved integrations.

Get mcp catalog by domain

Resolve one catalogued domain into its connectable surfaces — MCP endpoints, OpenAPI/GraphQL specs and CLIs — with each surface’s URL, transports and the credential alternatives it needs.

Get mcp clients

List this user’s organization OAuth connections as { connections }.

Get members

List the members of the connected organization with their role and last sign-in, plus the caller’s own user id and role and whether the caller may manage members.

Get models

Search the models an agent can run on — ids, context window, price per million tokens, and tool, reasoning and vision support.

Get notifications

The signed-in user’s daily digest preference (`digestOptOut`) and the timezone the digest is sent in (null when none was reported).

Get org mcp integrations

List the organization-owned MCP integrations: endpoint, auth mode, header names (never values), which groups and agents each is granted to, and every materialised agent’s connection status and last error.

Get orgs

List every organization the signed-in user belongs to, with their role and logo in each, plus the id of the currently active organization.

Get orgs brand logo

Look up the brand logo URL for a domain.

Get orgs current

Read the active organization’s id, name, logo domain and logo URL, and whether the caller may edit it (`canManage`).

Get orgs current build recommendations

Read the agent ideas Home shows for the active organization: up to three items (title, description, channel, prompt) the organization wrote itself, else generated from its saved website domain, else a generic set.

Get outcomes

Recorded business outcomes — sales, bookings, qualified leads — newest first, with totals per kind for the same agent, person and time scope.

Get payments

Read the organization’s Grosso payments account: connected, pending a signup code, or not connected; test or live; and whether Grosso still accepts its key.

Get payments payees

Read the organization’s newest 100 Grosso payees (businesses it collects payments for): owner email, business name, status, whether it can be charged, and the one agent it belongs to (null when unassigned).

Get people

Directory of the people behind the organization’s conversations, most recently seen first, with the total matching count.

Get people by person id

One person: their identities across channels, conversations, loops, connected accounts, and their confirmed outcome count and value.

Get provider accounts

List the organization’s own Photon accounts connected to Keiki: label, Photon project id, connection status (`active`, or `error` with a message when Keiki’s webhook or credentials stopped working) and the lines imported from each.

Get sandbox providers

Read sandbox provider availability as { providers }.

Get sandbox scripts

List the org’s sandbox scripts with the agents running each and its newest run — where a script that fails every boot shows up.

Get sandbox scripts by id

Read one sandbox script, including its body, targets, timeout and env secret names.

Get sandbox scripts runs

Every sandbox run of one script across its agents, newest first — status, exit code and output tails.

Get sandbox scripts versions

Version history of a sandbox script, newest first — each entry carries the commit sha to read it at.

Get sandbox scripts versions by sha

Read a sandbox script’s body as of one version, by the sha from its version history.

Get secrets

List the organization’s developer secret names with created/updated times and any host binding; values are never returned.

Get signals

Built-in quality signals across every agent in the org, or one agent: events, share of classified users, change against the previous period, and average mood.

Get skills

List the org’s skills and knowledge documents (metadata, no body) with the agents each is attached to.

Get skills by id

Read one skill or document, including its full body.

Get skills presets

List the built-in preset skills (id, capability, name, description, kind) and whether the org already added each.

Get skills versions

Version history of a skill, newest first — each entry carries the commit sha to read it at.

Get skills versions by sha

Read a skill’s body and metadata as of one version, by the sha from its version history.

Get sso

Read SSO connection, domains, eligibility and platform configuration.

Get trace exporters

List the destinations the org ships finished turns to — format, endpoint, header names (never values), enabled, attached agent ids, last delivery status — plus the formats available.

Get traces

List one page of the org’s agent turns (traces), newest first, with status, model, tokens and error.

Get traces by trace id

One turn with all its spans (every model step and tool call with full input/output).

Get traces count

Count the turns matching the same filters as /traces; returns { total }.

Get traces summary

What one turn did, in a small response: the reply it sent, every tool call with clipped input/output, and the spans that errored.

Get wallet programme

Whether agent wallets are offered on this deployment: each payment provider with whether it is configured and in test mode, plus overall configured/available flags.

Get webhook deliveries

List 50 outgoing consent/test webhook deliveries in this org, newest first.

Get webhook deliveries by id

Read one org-owned outgoing delivery, its immutable event payload and the latest 100 attempts.

Get webhooks

List the org’s webhook endpoints (id, name, url) — the targets an escalation route can post to.

Get webhooks by id

One webhook endpoint: its name, url and the events it subscribes to.

List agent templates

List the agent templates available for deployments.

List channel types

List the channel types and required deployment fields.

Patch identities group chat

Patch a Telegram identity’s group-chat behaviour — only the fields sent change; omitted fields keep their stored value.

Patch identities phone calls voice

Set a phone line's voice: answering model, ElevenLabs voice and delivery, first message, language, turn-taking, persona and tone.

Patch members by id

Change one member’s role, or their display name — one or the other per call.

Patch notifications

Update the signed-in user’s daily digest settings; only the fields sent change.

Patch orgs current

Rename the active organization, change its logo domain, or upload a logo; only the fields sent change.

Patch people by person id

Set the fields an operator owns on a person, patching only those sent: displayName, primaryEmail, notes.

Patch sso

Update IdP metadata/configuration and defaultRole, enforce, activate; returns SSO settings.

Post agent groups

Create an agent group, optionally with its members, and return its id.

Post agent groups end

Stop a whole group: end every live peer thread among its members and cancel their background tasks.

Post agentmail domains

Add a custom email domain for agent inboxes.

Post agents

Create an agent and return its id.

Post agents a2a

Turn the agent’s A2A endpoint and Agent Card on or off.

Post agents actions decide

Approve (run) or decline one pending agent action and return the updated action; when its inputs changed since it was proposed it comes back superseded with what changed.

Post agents actions groups decide

Approve or decline every pending action sharing a group id (from GET /agents/:id/actions), in order; approving stops at the first one that fails or is superseded.

Post agents api gateway

Turn the agent’s OpenAI/Anthropic-compatible API on or off, and/or switch passthrough mode (the caller’s own prompt leads each turn) — send at least one.

Post agents by id

Update an agent from its GET /agents/:id/edit config with your changes applied.

Post agents capabilities

Install a marketplace capability version on an agent, or re-pin an installed one to another version.

Post agents capabilities enabled

Enable or disable an installed capability, keeping its pinned version.

Post agents evals channel hosted

Start a real-channel eval run in which a platform-owned identity messages the agent over a real channel; returns the run id (watch it at /watch/:runId), the target handle and the cases run or excluded.

Post agents fine tune start

Record a fine-tune request for the agent’s current version; refused until enough graded conversations exist.

Post agents harness redeploy

Replace a Maritime agent’s Keiki VM with a fresh one built from the current runner and return the new VM status.

Post agents harness signing secret

Rotate an external harness credential; returns { signingSecret }.

Post agents lines

Give an agent another phone line.

Post agents lines move

Move a line this agent holds to another agent in one step.

Post agents loops clear history

Reset a loop: zero its run count and last status, delete its run history, and drop the snapshot it diffs against, so the next run starts fresh.

Post agents loops enabled

Pause or resume one of the agent’s scheduled loops.

Post agents loops run

Run one of the agent’s scheduled loops now, through the same pipeline as a scheduled run.

Post agents mcp presets connect

Connect (or reconnect) one MCP preset on the agent’s Executor daemon.

Post agents mcp presets share

Share an agent’s MCP connection with the organization: its credential moves to an org-owned integration granted to the given groups and agents, then installed on each.

Post agents mcp presets status

Re-check an MCP preset’s connection on the daemon without restarting OAuth — poll it after the user authorizes.

Post agents notice

Tell the agent something in its own conversations and let it decide whether the people in them hear about it — how you notify everyone using an agent (an outage, a capability going away, a migration).

Post agents quality apply

Apply a drafted fix to the agent’s live configuration (a new agent version).

Post agents quality dismiss

Dismiss a drafted fix, together with the failure cluster it came from so the same symptom is not suggested again.

Post agents quality settings

Change the agent’s turn-review settings.

Post agents rollouts percent

Set the share of conversations an open rollout serves its staged config to, and resume it when paused.

Post agents rollouts promote

Make the rollout’s staged config live for every conversation, recorded as a new version, and end the rollout.

Post agents rollouts rollback

End the rollout and send every conversation back to the live config.

Post agents template import

Re-apply the agent’s own template, at the template’s current version, onto its configuration (e.

Post agents tools

Save a new authored code tool as a disabled draft (saving under the name of an existing authored tool rewrites that draft).

Post agents tools enable

Publish an authored tool to the agent so it can call it, or unpublish it with enabled false.

Post agents versions restore

Roll the agent back to the configuration saved at a version sha, recorded as a new version whose sha is returned.

Post billing credits purchase

Buy usage credits for the organization; owners and admins only.

Post billing plans attach

Attach the selected plan to the organization; owners and admins only.

Post billing release line

Release an active phone line owned by the organization and unassign it from agents; owners and admins only.

Post channel access requests

Submit { channel, purpose, expectedVolume }; returns { request }.

Post conversations block

Block one identity for this conversation’s agent, so its messages no longer trigger agent replies.

Post conversations end

End an inter-agent (agent:) thread: settle its pending asks and refuse new ones until the identity is unblocked.

Post conversations messages

Send a message the contact reads as the agent’s, over the conversation’s own channel, and renew the takeover.

Post conversations steer

Run a turn on this conversation as if the contact had written the text, and return what the agent would answer with its trace id.

Post conversations takeover

Hold one conversation for a human for 30 minutes: incoming messages are stored for them to answer and no agent turn runs.

Post evals cases

Add a user-authored eval case to an agent in the organization and return the saved case.

Post evals cases generate

Re-author and persist the agent’s generated eval suite from its current configuration, keeping user and regression cases and recording a suite version.

Post evals diffs

Start paid-plan evals comparing two different readable config versions of the organization’s agent against up to 12 existing cases.

Post evals runs

Start a paid-plan eval run on the agent’s saved suite, or selected case ids including archived cases; generation occurs only if the saved suite is empty.

Post evals runs cancel

Request cooperative cancellation of an organization eval run that is still running; the runner checks between cases.

Post evals suggestions create

Create regression eval cases from selected production suggestions by replaying recorded conversation evidence in a mocked world, without model calls.

Post identities agentmail

Create an AgentMail email identity attached to an agent — a new inbox on the managed domain or one of the org’s verified custom domains, or an existing inbox the org already owns — and register its inbound webhook.

Post identities agentmail reconnect

Rotate an AgentMail identity’s inbox-scoped API key — mints a replacement, stores it, deletes the old key, and when attached re-registers the inbound webhook.

Post identities agentmail verify

Verify an AgentMail identity: re-fetches the inbox, and when the identity is attached to an agent (re)registers the inbound webhook.

Post identities attach

Route an identity to an agent: registers the channel’s inbound webhook or subscription and marks the identity routing-active.

Post identities detach

Stop routing an identity to its agent: tears down the channel’s webhook or subscription and leaves the identity unattached, so inbound messages stop being answered.

Post identities phone calls

Buy a voice number in the area code or state (or any US number when neither is given) and connect it to the agent for inbound phone calls (charges the org).

Post identities phone calls forwarding requests

Ask the team to set up call forwarding by hand for an iMessage line whose provider cannot do it automatically.

Post identities phone calls voices preview

Speak a short text (at most 300 characters; defaults to the first message) in a voice.

Post identities slack

Create a Slack identity from a manually-built Slack app: bot token and signing secret are required, the OAuth client pair makes the app installable by other workspaces.

Post identities slack install link

Mint a signed Slack install link that binds the installing workspace to an agent.

Post identities slack install links revoke

Stop every install link made so far for a customer-workspace Slack app, without touching its signing secret.

Post identities slack operators

Add one Slack user to a Slack identity’s operator allowlist without touching the other entries.

Post identities slack reconnect

Replace a Slack identity’s credentials with a fresh bot token for the same Slack app — the token must resolve to the app already connected — plus its signing secret.

Post identities slack signing probe

Store a candidate Slack signing secret and have the bot post a setup instruction into a channel; a human then mentions the bot there so Slack’s signed event proves the secret.

Post identities slack validate

Check pasted Slack app credentials before storing them: the workspace and bot the token belongs to, the scopes the install is missing, the channels the bot can see, whether the OAuth client pair is real, and whether the app is already connected.

Post identities slack verify

Re-check every workspace install of a Slack identity against Slack: refreshes workspace names and granted scopes, and retires an install whose token Slack has revoked.

Post identities teams

Create a Microsoft Teams identity from an Azure Bot registration — the App ID and a client secret are validated by minting a Bot Framework token.

Post identities telegram

Create a Telegram bot identity, optionally attached to an agent; the inbound webhook is registered only when an agent is attached.

Post identities telegram validate

Resolve a Telegram bot token through getMe and return the bot’s id, username and first name, without persisting anything.

Post identities whatsapp

Create a WhatsApp Cloud API identity, optionally attached to an agent; webhook subscription runs only when an agent is attached.

Post identities whatsapp kapso

Connect { phoneNumberId, agentId?

Post identities whatsapp kapso own

Connect { apiKey, phoneNumberId, agentId?

Post identities whatsapp kapso start

Mint an organization Kapso signup link; returns { url } for the user to open.

Post identities whatsapp validate

Resolve a Meta access token + phone number id to the WhatsApp number they belong to — display number and verified name — plus the webhook URL to register, without persisting anything.

Post identities x

Create an X account identity for public mentions and direct messages, from a completed “Log in with X” grant.

Post identities x oauth start

Start an X OAuth 2.

Post identities x reconnect

Replace the authorization of an X identity whose token X revoked, using a completed “Log in with X” for the same account.

Post identities x validate app credentials

Check that an X app API key + API key secret pair can mint the app-only bearer token that registers the X webhook, without storing anything.

Post invitations

Invite someone to the organization by email.

Post invitations resend

Resend a pending invitation with a fresh accept link and a renewed expiry.

Post keys

Create an API key, optionally bound to a single agent of this organization.

Post keys revoke

Revoke an API key so every later request with it is rejected.

Post keys rotate

Rotate an API key: the old secret stops working and the new full key is returned once.

Post lines contact card

Set the first and last name iMessage shows for a line, applied through its provider (Photon or Linq) and returned as the saved card.

Post lines preview

Quote a new iMessage line with a coupon applied, without charging, redeeming the coupon or provisioning: returns subtotal, total and currency (major units) and the next invoice, which may include other plans.

Post lines purchase

Buy a new iMessage line for the organization from Photon (default) or Blooio, optionally with a coupon and connected straight to an agent.

Post lines request

Ask the Keiki team for a Linq line.

Post lines verify

Check one line’s inbound webhook registration with its provider and its stored routing status; it changes nothing except promoting a degraded or unserved status back to active when the webhook checks out.

Post marketplace mine submit

Submit one of the organization’s own capability versions for marketplace publication review; it is emailed to the review inbox.

Post marketplace reviews by capability id

Approve (publish) or reject a capability that is awaiting review, with an optional note to the publisher.

Post members transfer ownership

Make another member the owner of the organization; the current owner becomes an admin.

Post org mcp integrations sync

Re-run the reconciliation of an org MCP integration into every granted agent now, in the background.

Post payments identity verification

Start payment identity verification; returns { url }.

Post payments key

Connect Grosso using { apiKey }; returns { account } without its key.

Post payments live

Switch payments to live mode; returns { account }.

Post payments payees

Create { ownerEmail, agentId, maxAmount, dailyAmount } (integer cents); returns { payee, onboardingUrl }.

Post payments payees by id

Assign a payee with { agentId }; returns { payee }.

Post payments signup

Start Grosso signup with { email, name }; returns { account }.

Post payments verify

Verify signup with { code, acceptTerms: true }; returns { account }.

Post sandbox scripts

Create a sandbox script: a "build" script runs once per sandbox (again when its body changes), a "startup" script on every boot.

Post skills

Create a skill or knowledge document — always a new one.

Post sso domains

Register { domain }; returns { domain } with its verification record.

Post sso setup link

Create a single-use SSO setup credential; returns { setupUrl, expiresAt }.

Post sso test

Start an SSO test; returns { url } for the user to open.

Post subagent tasks cancel

Cancel one running or suspended background task an agent delegated; the agent is told it was cancelled.

Post trace exporters

Add a destination that receives every finished turn of its attached agents.

Post traces abort

Ask a running turn to stop; it halts at its next step.

Post traces retry

Re-run a failed turn with its original input, or re-run its linked loop; returns which was queued.

Post webhook deliveries resend

Owners/admins only: queue a resend using the original event ID/payload.

Post webhooks

Create a named webhook endpoint.

Post webhooks signing secret

Rotate a destination webhook credential; returns { signingSecret }.

Post webhooks test

Queue a synthetic webhook delivery; returns { eventId } with status 202.

Put agent groups by id

Update an agent group: patches only the name and description sent, and when members is sent replaces the whole member list with it (read the group first to keep existing members).

Put agent groups note

Replace the whole group note with a new body and return the new revision; restoring a past version is a PUT of that version’s body.

Put agents harness connection

Configure an external harness with { mode: "inbox"|"push", dispatchUrl?

Put agents live

Pause an agent or put it back live.

Put agents mcp presets

Replace the agent’s whole MCP preset list (at most 10): presets left out are disconnected and removed, and editing a preset’s name, endpoint, kind, auth mode or headers reconnects it — read the agent’s current presets first and send them back with their ids.

Put agents mcp presets tool permissions

Replace the allow/ask/deny choices for one MCP’s tools and push them to the daemon.

Put agents note

Replace the whole working note body (read it first to keep what matters) and return the new revision.

Put agents public profile

Publish or unpublish the agent’s public profile page (which shows its name and phone line) and set its tagline.

Put agents tools by tool id

Update an authored tool.

Put agents user connections

Replace the agent’s personal provider definitions with the list sent (read GET first and keep the providers you are not changing) and return the saved list.

Put agents wallet

Update the agent’s wallet, creating it if needed: spending limits, approval threshold, merchant allowlist, user-card policy, payment method, payment provider (only while nothing is connected) or pause/resume.

Put billing auto top up

Turn auto top-up on or off; owners and admins only.

Put conversations contact card

Set the name, organization, title and optional photo for this conversation’s contact card.

Put evals cases by id

Replace an eval case’s editable fields and adopt it as user-authored so regeneration preserves it; read the current case first, since omitted history, world, channel, stubs, features and ordinary checks reset to defaults.

Put identities slack events webhook

Send a customer-workspace Slack app’s slack.

Put identities slack operators

Replace a Slack identity’s operator allowlist wholesale.

Put identities slack teams by team id

Route one customer Slack workspace to an agent, replacing any previous binding.

Put org mcp integrations credentials

Replace the authentication headers of a header-authenticated org MCP integration; every granted agent is reconnected with the new values in the background.

Put org mcp integrations grants

Replace the full set of groups and agents an org MCP integration is granted to — anything not listed loses access, so read the current grants first.

Put orgs current build recommendations

Replace the Home ideas the active organization wrote itself; they take precedence over the website-based ones.

Put sandbox scripts by id

Edit a sandbox script in place, patching only the fields sent; id, attachments and version history survive.

Put secrets by name

Store an encrypted secret with { value }; returns { ok, name }, never its value.

Put skills by id

Edit a skill in place, patching only the fields sent; its id, slug, agent attachments and version history survive.

Put trace exporters by id

Update a destination — replaces name, format, endpoint, enabled and agentIds, so read it first and send them all; headers are kept when omitted.

Put webhooks by id

Update a webhook endpoint — replaces both name and url, so send both.

Switch organization

List the organizations this account belongs to, or switch this connection to one of them.

Talk to agent

Send one message to one of this organization's agents as a real user, and read what it replies.

FAQ

Frequently asked questions

Start with Keiki MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Keiki MCP tool your agent needs.Free to start.

Start building