Skip to content
Sources/
Overview
Last updated

Sources

Sources are the connections between your external APIs and services and your Agen for SaaS MCP server. Each source provides the API definitions from which tools are automatically generated, allowing AI agents to discover and invoke your product's capabilities.

sources

Sources overview

The Sources screen displays all connected sources with the following information:

ColumnDescription
Source nameThe display name for the source (e.g., "Frontegg", "default").
TypeThe source type: REST, GRAPHQL, FRONTEGG, or MCP.
Connected toolsThe tools generated from this source, shown as badges.
EnabledA toggle to enable or disable the source.

Each source also has a delete button for permanent removal.

Source types

Agen for SaaS supports three source types, each designed for a different API paradigm.

REST source

A REST source connects to a REST API using an OpenAPI (Swagger) specification. When you add a REST source, Agen for SaaS parses the specification and extracts all endpoints as individual tools.

To add a REST source:

  1. Click Add source and select REST.
  2. Enter a Source name (required).
  3. Enter the API base URL (required) — this is where tool requests are forwarded (e.g., https://api.yourdomain.com).
  4. Provide your OpenAPI specification using one of two methods:
    • Upload file — Upload a JSON or YAML file containing your OpenAPI spec.
    • Paste code — Paste the OpenAPI JSON directly into the code editor.
  5. Click Generate tools to extract endpoints and parameters from the specification.
  6. Click Save to finalize the source.

The code editor displays the OpenAPI specification with syntax highlighting. A minimal OpenAPI 3.0 template is provided by default:

{
  "openapi": "3.0.0",
  "info": {
    "title": "API",
    "version": "1.0.0"
  },
  "paths": {
    "/": {
      "get": {
        "summary": "Get API",
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  }
}

GraphQL source

A GraphQL source connects to a GraphQL API using a schema definition. Agen for SaaS parses the schema and extracts queries, mutations, and types as tools.

To add a GraphQL source:

  1. Click Add source and select GraphQL.
  2. Enter a Source name (required).
  3. Enter the API base URL (required).
  4. Provide your GraphQL schema using one of two methods:
    • Upload file — Upload a .graphql or .gql schema file.
    • Paste code — Paste the GraphQL SDL directly into the code editor.
  5. Click Generate tools to extract queries and mutations from the schema.
  6. Click Save to finalize the source.

The code editor includes a commented-out schema template:

# type Query {
#   hello: String
# }

MCP server source

An MCP server source connects to a remote MCP-compatible server. Tools are discovered dynamically through the MCP protocol rather than parsed from a static specification.

Adding an MCP source follows a three-step wizard:

Step 1: Configuration

  • Enter a Source name (required).
  • Enter the MCP URL (required) — the remote MCP server endpoint (e.g., https://example.com).
  • Set the API timeout — the maximum time (in milliseconds) to wait for a response from the remote server. Default: 5000 ms. Adjustable with +/- controls.

Step 2: Link

  • Generates the connection link between your Agen for SaaS MCP gateway and the remote MCP server.

Step 3: Tools

  • Displays the tools discovered from the remote MCP server.

Click Create source to finalize, or Discard to cancel.

Frontegg source

When your Agen for SaaS instance is configured, a Frontegg source is automatically available. This built-in source exposes Frontegg's own API capabilities (such as approval flow controllers, geo-fence controllers, and IP restriction controllers) as tools. The Frontegg source type appears as FRONTEGG in the Type column.

Managing sources

Enable or disable a source

Use the toggle in the Enabled column to activate or deactivate a source. Disabling a source prevents all its connected tools from being discoverable by AI agents.

Delete a source

Click the trash icon next to a source to permanently remove it. This also removes all tools generated from that source.