Skip to content
Covo Developers

Start here

Quickstart

Make your first call to Covo in five minutes, with a personal access token or through OAuth.

1. Get a token

In Studio, open Settings, then Developer Access, and choose Create a token. Pick a preset (Read only, Development or Deployment), the Concierges it may reach, and when it expires. Copy the token: it starts with cc_pat_ and is shown once.

Apps that support OAuth (Meta Muse, ChatGPT, Claude, Grok and most coding tools) do not need a token: the person approves the app instead. See Authentication.

2. Call the API

export COVO_TOKEN=cc_pat_...
curl https://covo.lanaai.io/api/v1/me -H "Authorization: Bearer $COVO_TOKEN"

You get the account, the token's scopes and the agents it can reach. Then list agents:

curl https://covo.lanaai.io/api/v1/agents -H "Authorization: Bearer $COVO_TOKEN"

3. Or connect over MCP

Point any MCP client at the server with the token as a bearer header. With Claude Code:

claude mcp add --transport http covo https://covo.lanaai.io/mcp \
  --header "Authorization: Bearer $COVO_TOKEN"

Then ask the assistant to run get_account and list_agents. Other tools: Coding tools.

4. Make a safe change

  1. Read with get_agent_configuration and note revision.
  2. Check with preview_agent_changes (changes nothing).
  3. Apply with update_agent_configuration, sending expected_revision. A version is saved first, so restore_version can undo it.
  4. Test with run_agent_test, then publish with publish_agent and confirm: true once the person agrees.

The full sequence and why: Safe change workflow.