Resources

Resources represent external systems that tools can interact with.

Overview

Synatra supports five resource types:

Resource Type	Description	Connection Mode
PostgreSQL	Connect to PostgreSQL databases	Direct or Connector
MySQL	Connect to MySQL databases	Direct or Connector
Stripe	Access Stripe payment APIs	Direct only
GitHub	Access GitHub repository APIs	Direct only (OAuth)
Intercom	Access Intercom APIs	Direct only (OAuth)

Security

All resource credentials are:

• Encrypted at rest using AES
• Decrypted only in the Resource Gateway
• Never exposed to user code directly

Creating a Resource

1. Navigate to Resources in the Console
2. Click New Resource
3. Select the resource type
4. Enter connection details
5. Test the connection

Using Resources in Tools

Resources are available in tool code via the context.resources object:

// PostgreSQL
const result = await context.resources.db.query("SELECT * FROM users WHERE id = $1", [userId])

// MySQL
const result = await context.resources.db.query("SELECT * FROM orders WHERE customer_id = ?", [customerId])

// Stripe
const customer = await context.resources.stripe.request("GET", `/v1/customers/${customerId}`)

// GitHub
const issues = await context.resources.github.request("GET", "/repos/myorg/myrepo/issues?state=open")

// Intercom
const conversations = await context.resources.intercom.request("GET", "/conversations")

Connection Modes

Resources can connect in two modes:

• Direct: Resource Gateway connects directly using stored credentials
• Connector: Queries routed through a Connector running in your network (for databases in private VPCs)

Resource Gateway

The Resource Gateway is an internal service that:

• Manages connection pools for databases
• Handles OAuth token refresh for GitHub and Intercom
• Enforces rate limits
• Logs all external access
• Provides network isolation