Integrations

Connectors to outside systems: sync, send, inbound events.

Start with: connectors_types, connectors_create, connectors_sync, connectors_send.

12 operations. Discover them from an agent with agentdb_capabilities {"category": "integrations"}.

#`connectors.inbound`

experimental

Receive a signed inbound event for a connector (no API key)

Experimental: may change before 2.0.

REST: POST /v1/inbound/{ws}/{connector} no authentication

Parameter	In	Type	Required	Description
`ws`	path	`string`	yes	string
`connector`	path	`string`	yes	string

Example

REST

curl -s -X POST "https://app.agentdb.link/v1/inbound/$AGENTDB_WORKSPACE/<connector>"

#`connectors_create`

experimental added in 1.0.0-rc.6 changes data

Configure a connector (owners/admins). credentials are stored encrypted and never shown again (only their field names). inbound=true returns a signing secret ONCE for POST /v1/inbound/<workspace>/<connector>. External actions need allowed_actions and an outbound_webhook_id. Schedule syncs with jobs_create {action: {type: connector_sync, connector_id}}. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_create
REST: POST /v1/workspaces/{ws}/connectors scope records:write
CLI: agentdb connectors create

Arguments

Argument	Type	Required	Description
`name`	`string`	yes	string, 1–100 characters
`type`	`string`	yes	string, up to 64 characters
`config`	`object`		object, default {}
`credentials`	`object`		object
`inbound`	`boolean`		boolean, default false
`outbound_webhook_id`	`string`		string, up to 64 characters
`allowed_actions`	`string[]`		string[], up to 20 items, default []
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_create",
  "arguments": {
    "name": "No-op test",
    "type": "noop"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_create",
    "arguments": {
      "name": "No-op test",
      "type": "noop"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"No-op test","type":"noop"}'

CLI

agentdb connectors create [options]

#`connectors_delete`

experimental added in 1.0.0-rc.6 changes data destructive

Delete a connector. Also its runs, inbound events and sync jobs. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_delete
REST: DELETE /v1/workspaces/{ws}/connectors/{connector} scope records:write
CLI: agentdb connectors delete

Arguments

Argument	Type	Required	Description
`connector_id`	`string`	yes	Connector id (con_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_delete",
  "arguments": {
    "connector_id": "con_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_delete",
    "arguments": {
      "connector_id": "con_example"
    }
  }
}

REST

curl -s -X DELETE "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb connectors delete [options] <connector_id>

#`connectors_get`

experimental added in 1.0.0-rc.6 read-only

One connector. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_get
REST: GET /v1/workspaces/{ws}/connectors/{connector} scope records:read
CLI: agentdb connectors get

Arguments

Argument	Type	Required	Description
`connector_id`	`string`	yes	Connector id (con_...)
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_get",
  "arguments": {
    "connector_id": "con_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_get",
    "arguments": {
      "connector_id": "con_example"
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb connectors get [options] <connector_id>

#`connectors_inbound_events`

experimental added in 1.0.0-rc.6 read-only

Verified inbound events. Newest first; status received | processed | failed. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_inbound_events
REST: GET /v1/workspaces/{ws}/connector-inbound-events scope records:read
CLI: agentdb connectors inbound-events

Arguments

Argument	Type	Description
`connector_id`	`string`	string, up to 64 characters
`limit`	`integer`	integer, 1–100, default 50
`cursor`	`integer`	integer, at least 1
`workspace`	`string`	Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_inbound_events",
  "arguments": {
    "connector_id": "con_example",
    "limit": 10
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_inbound_events",
    "arguments": {
      "connector_id": "con_example",
      "limit": 10
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connector-inbound-events" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb connectors inbound-events [options]

#`connectors_list`

experimental added in 1.0.0-rc.6 read-only

List connectors. Status, last run, sync jobs; never credentials. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_list
REST: GET /v1/workspaces/{ws}/connectors scope records:read
CLI: agentdb connectors list

Arguments

Argument	Type	Required	Description
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_list",
  "arguments": {}
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_list",
    "arguments": {}
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb connectors list [options]

#`connectors_rotate_inbound_secret`

experimental added in 1.0.0-rc.6 changes data

New inbound signing secret. Returned once; the old one stops working at once. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_rotate_inbound_secret
REST: POST /v1/workspaces/{ws}/connectors/{connector}/rotate-inbound-secret scope records:write
CLI: agentdb connectors rotate-inbound-secret

Arguments

Argument	Type	Required	Description
`connector_id`	`string`	yes	Connector id (con_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_rotate_inbound_secret",
  "arguments": {
    "connector_id": "con_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_rotate_inbound_secret",
    "arguments": {
      "connector_id": "con_example"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example/rotate-inbound-secret" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb connectors rotate-inbound-secret [options] <connector_id>

#`connectors_runs`

experimental added in 1.0.0-rc.6 read-only

Sync run history. Newest first: trigger, status, stats or error (credentials are never included). Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_runs
REST: GET /v1/workspaces/{ws}/connector-runs scope records:read
CLI: agentdb connectors runs

Arguments

Argument	Type	Description
`connector_id`	`string`	string, up to 64 characters
`status`	`"succeeded" \| "failed"`	string, one of: succeeded, failed
`limit`	`integer`	integer, 1–100, default 50
`cursor`	`integer`	integer, at least 1
`workspace`	`string`	Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_runs",
  "arguments": {
    "connector_id": "con_example",
    "limit": 10
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_runs",
    "arguments": {
      "connector_id": "con_example",
      "limit": 10
    }
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connector-runs" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb connectors runs [options]

#`connectors_send`

experimental added in 1.0.0-rc.6 changes data

Perform an allowed external action. Delivered through the connector's outbound webhook (signed, retried, see webhooks_deliveries). Refused unless the action is in allowed_actions. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_send
REST: POST /v1/workspaces/{ws}/connectors/{connector}/actions scope records:write
CLI: agentdb connectors send

Arguments

Argument	Type	Required	Description
`action`	`string`	yes	string
`payload`	`object`		object, default {}
`connector_id`	`string`	yes	Connector id (con_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_send",
  "arguments": {
    "connector_id": "con_example",
    "action": "send_message",
    "payload": {
      "text": "Hello"
    }
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_send",
    "arguments": {
      "connector_id": "con_example",
      "action": "send_message",
      "payload": {
        "text": "Hello"
      }
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example/actions" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"send_message","payload":{"text":"Hello"}}'

CLI

agentdb connectors send [options] <connector_id>

#`connectors_sync`

experimental added in 1.0.0-rc.6 changes data

Run a sync now. A failure is recorded (run status failed, connector status error, connector.sync_failed event) and can be retried by calling this again. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_sync
REST: POST /v1/workspaces/{ws}/connectors/{connector}/sync scope records:write
CLI: agentdb connectors sync

Arguments

Argument	Type	Required	Description
`connector_id`	`string`	yes	Connector id (con_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_sync",
  "arguments": {
    "connector_id": "con_example"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_sync",
    "arguments": {
      "connector_id": "con_example"
    }
  }
}

REST

curl -s -X POST "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example/sync" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

CLI

agentdb connectors sync [options] <connector_id>

#`connectors_types`

experimental added in 1.0.0-rc.6 read-only

Connector types on this server. Config schema, credential field names, sync/inbound/actions, quotas. Real providers are not built in; noop always, mock only when test doubles are on. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_types
REST: GET /v1/workspaces/{ws}/connector-types scope records:read
CLI: agentdb connectors types

Arguments

Argument	Type	Required	Description
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_types",
  "arguments": {}
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_types",
    "arguments": {}
  }
}

REST

curl -s "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connector-types" \
  -H "Authorization: Bearer $AGENTDB_TOKEN"

CLI

agentdb connectors types [options]

#`connectors_update`

experimental added in 1.0.0-rc.6 changes data

Change a connector. config, credentials (replaces all = rotation), status paused|active, outbound_webhook_id, allowed_actions. Experimental: may change before 2.0.

Experimental: may change before 2.0. No real provider is built in yet (noop and the mock only); the connector contract may change with the first one.

MCP tool: connectors_update
REST: PATCH /v1/workspaces/{ws}/connectors/{connector} scope records:write
CLI: agentdb connectors update

Arguments

Argument	Type	Required	Description
`name`	`string`		string, 1–100 characters
`config`	`object`		object
`credentials`	`object`		object
`status`	`"active" \| "paused"`		string, one of: active, paused
`outbound_webhook_id`	`string \| null`		string \| null
`allowed_actions`	`string[]`		string[], up to 20 items
`connector_id`	`string`	yes	Connector id (con_...)
`idempotency_key`	`string`		Optional retry key ([A-Za-z0-9._:-], max 255). Repeating a call with the same key and arguments returns the original result without writing again.
`workspace`	`string`		Workspace id (preferred), slug or exact name. Omit for the default workspace. Resolve names once with workspace_select.

Example

MCP

{
  "tool": "connectors_update",
  "arguments": {
    "connector_id": "con_example",
    "status": "paused"
  }
}

MCP via agentdb_execute

{
  "tool": "agentdb_execute",
  "arguments": {
    "operation": "connectors_update",
    "arguments": {
      "connector_id": "con_example",
      "status": "paused"
    }
  }
}

REST

curl -s -X PATCH "https://app.agentdb.link/v1/workspaces/$AGENTDB_WORKSPACE/connectors/con_example" \
  -H "Authorization: Bearer $AGENTDB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

CLI

agentdb connectors update [options] <connector_id>

Integrations

#connectors.inbound

Example

#connectors_create

Arguments

Example

#connectors_delete

Arguments

Example

#connectors_get

Arguments

Example

#connectors_inbound_events

Arguments

Example

#connectors_list

Arguments

Example

#connectors_rotate_inbound_secret

Arguments

Example

#connectors_runs

Arguments

Example

#connectors_send

Arguments

Example

#connectors_sync

Arguments

Example

#connectors_types

Arguments

Example

#connectors_update

Arguments

Example

#`connectors.inbound`

#`connectors_create`

#`connectors_delete`

#`connectors_get`

#`connectors_inbound_events`

#`connectors_list`

#`connectors_rotate_inbound_secret`

#`connectors_runs`

#`connectors_send`

#`connectors_sync`

#`connectors_types`

#`connectors_update`