Understanding Connectors
Connectors are the core building blocks of Agentsyx. Understanding how they work is essential for setting up your MCP apps.
What Are Connectors?
Connectors are MCP (Model Context Protocol) servers that enable communication between the AI Host and your backend services. Agentsyx uses two types of connectors:
- Downstream Connectors - Your backend MCP servers
- Upstream Connectors - Agentsyx's MCP endpoints that aggregate the downstream connectors for the AI Host (agent) while wrapping them in a Business Operations Layer (SaaS)
Downstream Connectors
Downstream connectors are the backend services that do the actual work. They can be:
Supported Types
- Zapier MCP Server - Connect to Zapier integrations
- Make MCP Server - Connect to Make.com workflows
- n8n MCP Server - Connect to n8n integrations and automations
- OpenAI App SDK MCP - Custom MCP servers built with MCP SDK, including ext-apps (MCP App) extension
- Custom MCP Servers - Any MCP-compatible service
- Agentsyx Service - Built-in service for support queue functionality [coming soon]
How They Work
Downstream connectors:
- Expose tools that can be aggregated by the upstream connectors and called by the AI Hosts
- Execute the actual business logic
- Return results to Agentsyx
- Can be hosted anywhere (your servers, cloud, etc.)
Upstream Connectors
Upstream connectors are Agentsyx's MCP endpoints that MCP-capable AI hosts connect to. They:
- Handle authentication and user context
- Manage billing and usage tracking
- Route requests to downstream connectors
- Provide tools to the upstream AI Hosts
Creating an Upstream Connector
When you create an upstream connector:
- Select which downstream connectors to use
- Choose which tools to expose
- Set credit prices for each tool
- Configure authentication and access
The Flow
Here's how requests flow through the system:
- End user uses your product (web app and/or an AI host)
- AI Host and agents call a tool via your Upstream Connector (Agentsyx)
- Agentsyx authenticates the user and checks credits
- Agentsyx routes the request to the appropriate Downstream Connector
- Downstream Connector executes the work and returns results
- Agentsyx deducts credits and logs usage
- Results flow back to the AI Host (agent) and the end user
Tool Mapping
Tool mapping is the process of:
- Selecting tools from downstream connectors
- Exposing them through your upstream connector
- Setting credit prices for each tool
- Configuring tool behavior and access