Connectors

Every connector either feeds data into the knowledge graph (ingest), exposes live tools to the agent loop (tools), or both. Pick one to read its setup guide.

Conceptual background: Connectors & Tool Providers.

GitHub

Cloud & Infra

Repos, PRs, issues, code search, CI runs.

● Ingest ● Tools

PATOAuthGitHub App

AWS

Cloud & Infra

EC2, S3, IAM, Lambda, CloudWatch — read-only.

● Ingest ● Tools

KeysAssumeRoleInstance Profile

GCP

Cloud & Infra

Compute, IAM, GCS, BigQuery — scoped reads.

● Ingest ● Tools

Service accountADC

Vercel

Cloud & Infra

Projects, deployments, env vars, logs.

● Ingest ● Tools

API token

Supabase

Cloud & Infra

Tables, schemas, RLS policies, edge functions.

● Ingest ● Tools

Service role key

Kubernetes

Cloud & Infra

Pods, deployments, services, events, logs.

● Ingest ● Tools

kubeconfigin-cluster SA

LocalStack

Cloud & Infra

Local AWS emulator for testing and dev.

● Ingest ● Tools

Dummy keys

Jenkins

Cloud & Infra

Jobs, builds, pipelines, console output.

● Ingest ● Tools

API token

Grafana

Cloud & Infra

Dashboards, panels, alerts, datasources.

● Ingest ● Tools

API tokenService account

SQL

Data

Postgres, MySQL, SQLite — schema-aware queries.

● Ingest ● Tools

User + password

MongoDB

Data

Collections, documents, aggregations.

● Ingest ● Tools

Connection string

Power BI

Data

Workspaces, datasets, reports, refresh runs.

● Ingest ● Tools

Azure ADService principal

CSV & JSON

Data

Bulk file uploads — schemas inferred at ingest.

● Ingest ○ Tools

File upload

Slack

Communication

Channels, threads, search, send messages.

● Ingest ● Tools

OAuthBot token

Google Workspace

Communication

Gmail, Drive, Calendar, Docs, Sheets.

● Ingest ● Tools

OAuth

Read.ai

Communication

Meeting transcripts, summaries, action items.

● Ingest ● Tools

OAuth

HubSpot

Communication

Contacts, companies, deals, sequences.

● Ingest ● Tools

Private appOAuth

Figma

Communication

Files, frames, comments, components.

● Ingest ● Tools

PAT

OneDrive

Communication

Files, folders, shared workspaces.

● Ingest ● Tools

OAuth

Firecrawl

AI & Media

Web crawling, scraping, structured extraction.

○ Ingest ● Tools

API key

Web Search

AI & Media

Tavily, SerpAPI, Brave — agent web access.

○ Ingest ● Tools

API key

ElevenLabs

AI & Media

Text-to-speech, voice cloning, audio gen.

○ Ingest ● Tools

API key

Runway

AI & Media

Image and video generation models.

○ Ingest ● Tools

API key

Remotion

AI & Media

Programmatic video rendering in a sandbox.

○ Ingest ● Tools

Local sandbox

Coding Agents

AI & Media

Claude Code, Codex, Aider — sandboxed dev work.

○ Ingest ● Tools

—

OS Sandbox

AI & Media

Isolated shells for safe agent execution.

○ Ingest ● Tools

—

Remote Execution

AI & Media

Run jobs on remote workers via signed tokens.

○ Ingest ● Tools

Worker token

OpenAPI

Extensibility

Drop in any OpenAPI spec — instant tools.

● Ingest ● Tools

BearerBasicAPI key

MCP

Extensibility

Model Context Protocol — bring your own server.

○ Ingest ● Tools

Server-defined

Git

Extensibility

Any Git repo — index commits, branches, files.

● Ingest ○ Tools

SSHHTTPS

Custom

Extensibility

Implement the trait, register, ship.

● Ingest ● Tools

User-defined

Feature-gated availability

Connectors compile in via Cargo features. For most self-hosts, leave all features on. Slim builds:

cargo build -p agentcy-api --release \
  --no-default-features \
  --features "connectors-cloud connectors-data"

See Concept: Connectors.

Register a connector instance

Same pattern for every connector — the UI is easier, but here's the API:

curl -X POST http://localhost:8080/api/v1/sources \
  -H "authorization: Bearer $TOKEN" -H 'content-type: application/json' \
  -d '{
    "name":"github-primary",
    "connector":"github",
    "realm":"development",
    "config":{"auth":{"kind":"pat","token":"ghp_…"},"repos":["acme/monolith","acme/webapp"]}
  }'

Validation runs synchronously. Invalid credentials → 422 with error.code = "source_validation_failed".

First sync:

curl -X POST "http://…/sources/$SOURCE_ID/sync" -H "authorization: Bearer $TOKEN"

Drop into Pipelines when you need scheduled, multi-step, revertible syncs.

Tool discovery

Every connector's live tools are searchable via the agent loop's search_connector_tools. From the REST API:

curl "http://…/skills?kind=connector_tool&connector=kubernetes" \
  -H "authorization: Bearer $TOKEN" | jq '.items[] | {name, description}'

Writing a connector

Guide: Custom Connectors. Implement one or both traits from agentcy-ingest / agentcy-core, register in state.rs, ship.