Skip to main content

Use the MCP server and the API

For developers: connect MCP clients with an agent key, or call the same tools over HTTPS described by an OpenAPI document.

Who it's for
Developers.
What you need first
Time needed
About 10 minutes

Steps

  1. Step 1: Open AI agents settings and go to Connect your AI assistant.

  2. Step 2: For an MCP client, copy the MCP client config shown with your new key, or send the key as a bearer token to the MCP server URL.

  3. Step 3: For HTTPS, select Copy OpenAPI URL and load the OpenAPI document.

  4. Step 4: Read the API docs for every endpoint, error code and example.

  5. Step 5: Start with read-only tools, such as listing transport modes, before posting jobs.

What happens next

Every call is logged in your agent activity and stays within the key's limits.

Common problems and fixes

A call returns pending_approval.

It's above your approval threshold and waits for you in CouthActs. Don't retry it; approve it instead.

Did this guide help?