Skip to main content
A connector is a ready-made integration from the Rerun library: Stripe, Gmail, Notion, Slack and hundreds more. Declaring one on an agent gives it that service tools. See Connectors for the concept.
No credential ever goes through the API. attach_connector takes no secret, by design. Never ask anyone for an API key, a password or a token: the account owner finishes the connection in the Rerun app.

​
search_connectors

Semantic search over the library. Describe the capability in natural language.
​
string
For example send emails or read a CRM.
​
string
One of payments, ecommerce, crm, marketing, seo, analytics, dev, productivity, other.
Each result carries slug, name, category, summary, setup and setupReason. Use the slug with attach_connector. setup tells you what declaring it will leave behind: This search returns the best matches only. Use list_connectors when you need to know whether something exists at all.

​
list_connectors

Walks the whole library page by page, in a stable order.
​
string
​
number
Default 60, maximum 200.
​
number
Default 0.
Returns total alongside the page, so you know when you are done. Use it to prove a connector is absent, which a semantic search can never do.

​
list_agent_connectors

Lists the connectors declared on an agent with their real status and the tool names each one contributes.
​
string
required
This is the truth, whatever the catalog predicted at search time.

​
attach_connector

Declares a connector on an agent.
​
string
required
​
string
required
Catalog slug, from search_connectors.
When the connector needs no credential and no sign-in, it is installed right away. Otherwise it is recorded as pending, and the account owner finishes the connection from the Rerun app, in the agent panel under Connectors. The response carries the resulting status, the available authMethods when one is still pending, and a message describing what is left to do.
Declaring a connector on an agent that will become a template is exactly the intended use. The person installing the template connects their own account.

​
detach_connector

Removes a connector from an agent: its tools, its credentials and the skill it installed.
​
string
required
​
string
required
​
boolean
required
Must be true.