---
title: "List Providers"
method: GET
path: "/api/integrations/providers"
tags: ["v1", "integrations"]
---

# List Providers

`GET /api/integrations/providers`

Get metadata for every available provider.

Returns both statically defined providers (from ``ProviderName`` enum) and
dynamically registered providers (from SDK decorators). Each entry includes
a ``description`` declared via ``ProviderBuilder.with_description(...)`` in
the provider's ``_config.py``.

Official MCP catalog entries are appended as display metadata and use the
generic MCP connection flow. They are not registered credential providers,
so PROVIDER_NAMES continues to contain only credential-provider names.

## Response `200`

Successful Response

- ProviderMetadata[]
  - `name` string, required — Provider slug (e.g. ``github``)
  - `display_name` string, nullable — Human-readable provider name
  - `mcp_server` MCPServerMetadata
    - `server_url` string, nullable
    - `documentation_url` string, required
    - `setup_instructions` string, required
    - `connection_mode` 'hosted' | 'custom', required
    - `auth_methods` string[], required
    - `server_url_options` MCPServerURLPreset[]
      - `label` string, required
      - `url` string, required
    - `oauth_server_url` string, nullable
    - `oauth_scopes` string[], nullable
    - `oauth_write_scopes` string[]
    - `icon_id` string, nullable
  - `description` string, nullable — One-line human-readable summary of what the provider does. Declared via ``ProviderBuilder.with_description(...)`` in the provider's ``_config.py``. ``None`` if not set.
  - `supported_auth_types` string[] — Credential types this provider accepts. Drives which connection tabs the settings UI renders for the provider. Empty list means no auth types declared.

## Changes

- **2026-09-17** `5f27fa9d6c03` — 2 info
  - added the optional property `items/display_name` to the response with the `200` status
  - added the optional property `items/mcp_server` to the response with the `200` status
- **2026-08-20** `ae1be5efc67a` — 1 warning
  - added the new `device_code` enum value to the `items/supported_auth_types/items/` response property for the response status `200`
- **2026-08-12** `316dc5984754` — 1 info
  - the endpoint scheme security `HTTPBearer` was added to the API

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/integrations/providers/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)