Integrations

Connect Any Data or Service

Integrations turn Aethera agents into power‑users of your tech stack. Each connector is packaged as an MCP Tool: a signed manifest + executable endpoint that runs inside a warm‑pooled micro‑VM sandbox. Once connected, tools appear in the Builder → Tools

11.1 Connector Catalog

Category	Integration	Key Actions (tool.call)	Auth Method	Notes
Communication	Slack	chat.post, files.upload, reactions.add	OAuth 2 (bot token)	Channel whitelist in Policy
	Discord	message.send, file.upload	Bot token	Supports embeds
Dev & DevOps	GitHub	issues.create, pr.comment, repo.get	OAuth App / PAT	Fine‑grained repo scopes
	Docker	registry.push, registry.pull	PAT	Private registries supported
	Terraform	plan.apply, state.get	PAT / Cloud API token	Dry‑run policy flag
	Amazon EKS	kubectl.exec, deploy.rollout	IAM Role / Key	Works with OIDC clusters
Payments	Stripe	invoice.create, customer.get, webhook.listen	API Key	PII redaction on by default
	PayPal	order.capture, refund.issue	OAuth 2	Sandbox & Live modes
Databases	PostgreSQL	query, exec	Conn string + TLS cert	Read‑only default
	MongoDB	find, aggregate, insert	URI + TLS	Supports Atlas
	SupaBase	sql, rpc, storage.upload	Service key	Row‑level security respected
Cloud Storage	AWS S3	get, put, list	IAM Role / Key	Server‑side encryption SSE‑S3
	Google Drive	file.list, file.export, upload	OAuth 2	Team drives supported
Productivity	Microsoft 365 / Azure	mail.send, graph.query, files.get	OAuth 2 (Graph)	Data stays in-region
	Notion	page.create, database.query	OAuth 2	Parent page picker
Automation	Zapier	zap.trigger, zap.list	OAuth 2	5-sec min latency
Networking & Security	Cloudflare	dns.create, purge_cache	API Token	Zone‑scoped permissions
Search & Analytics	Elasticsearch	search, index.put, agg	Basic / API Key	Multi‑cluster routing
AI & Data	ElevenLabs	speech.synthesize, voice.clone	API Key	< 1 MB audio cap
	Fire Crawl	web.search, url.scrape	API Key	On‑the‑fly page embeddings
Custom	REST / GraphQL	Any verb	Bearer / HMAC	Use Adapter Kit

vailability: All connectors are GA except Cloudflare (beta) and PayPal (beta).

11.2 Connecting a Tool – Wizard Walk‑Through

1. Integrations nav → click a card (e.g., Stripe).

2. Authenticate – OAuth popup or API key form.

3. Select Scopes – The wizard suggests least‑privilege ticks.

4. Name the Connection (e.g., stripe_prod).

5. Save & Test – The wizard runs a harmless ping (e.g., GET /v1/account).

6. Done – Tool appears as stripe.invoice.create etc.

Tip ✨ Create separate connections for staging vs production; attach via Policy per namespace.

11.3 Using Tools in Prompts & Tasks

Prompt snippet:

You have access to stripe.invoice.create to generate an invoice. After creating, post a confirmation to Slack using slack.chat.post.

The agent plan might resolve:

1. stripe.invoice.create({...})

2. slack.chat.post({channel: "#billing", text: "Invoice sent 🚀"})

Timeline logs show each step with response payloads.

11.4 Micro-VM Sandbox Scopes & Egress Policy

Each tool call runs in an isolated micro‑VM sandbox with:

• Outbound IP Pool – Whitelisted per integration (rotate weekly).

• Timeout – 30 s default, override per call (timeout_ms).

• Payload Cap – 8 MB; larger files auto‑chunk or require pre‑signed URLs.

• Egress Guard – Policy rule allow_egress("stripe.com") etc.

• Startup Time – <200ms for warm-pooled containers

11.5 Custom API → MCP Adapter

1. Fork Adapter Kit: git clone https://github.com/aethera-labs/mcp-adapter-kit.git

2. Edit manifest.json → describe actions, inputs, outputs.

3. Implement handlers in app.py (Flask / FastAPI).

4. Run local: docker compose up → health check returns ok.

5. Sign: aethera sign-manifest manifest.json --cert your_cert.pem.

6. Publish: aethera publish mytool/ --namespace acme_inc.

7. Grant scopes via Policy and test in Builder.

Email [e-mail] for architecture reviews or to list your adapter in the public catalog.

Best Practices

• Schema First – Define JSONSchema for inputs/outputs; agents benefit from typed reflections.

• Idempotent Handlers – Ensure retries are safe; idempotency key header recommended.

• Observability – Emit OpenTelemetry traces via helper lib aethotel.

• Version Pinning – Increment version in manifest; old versions kept 30 days.

11.6 Troubleshooting Connections

Symptom	Likely Cause	Resolution
AuthError on first call	Expired token / wrong scopes	Re‑auth in Integrations wizard
PolicyDenied	Policy rule blocking tool or domain	Check Policy Journal entry
PayloadTooLarge	> 8 MB body	Upload via S3 pre‑signed URL
High latency spikes	Third‑party API slowness	Set circuit‑breaker or queue task