List integrations

veryfront__list_integrations

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Read-only.

Arguments

FieldTypeRequiredDescription and constraints
searchstringNoSearch query to filter integrations by name or description
limitintegerNoNumber of results per page (default: 20, max: 100) Default: 20. Minimum: 1. Maximum: 100.
cursorstringNoPagination cursor from previous response
availabilitystring[]NoOnly integrations with one of these availabilities: default, experimental or host_adapter.
auth_typestring[]NoOnly integrations with one of these authentication types: oauth2, oauth1, api-key or basic.
categorystring[]NoOnly integrations in one of these categories. Integrations without a category match no value.
sort_bystringNoSort by display name, with ties broken by integration name ascending. Values: "name".
sort_orderstringNoSort order. Defaults to asc. Values: "asc", "desc".

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__list_integrations",
    "arguments": {}
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
dataobject[]YesPrimary result records returned by the tool.
totalintegerYesTotal number of integrations matching the query Minimum: 0.
page_infoobjectYesPagination cursor values for traversing the result set.

Full schemas

json
{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "description": "Search query to filter integrations by name or description"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Number of results per page (default: 20, max: 100)",
      "default": 20
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response"
    },
    "availability": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "default",
          "experimental",
          "host_adapter"
        ],
        "description": "One availability item supplied to the tool."
      },
      "maxItems": 16,
      "description": "Only integrations with one of these availabilities: default, experimental or host_adapter."
    },
    "auth_type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "oauth2",
          "oauth1",
          "api-key",
          "basic"
        ],
        "description": "One auth type item supplied to the tool."
      },
      "maxItems": 16,
      "description": "Only integrations with one of these authentication types: oauth2, oauth1, api-key or basic."
    },
    "category": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9-]+$",
        "description": "One category item supplied to the tool."
      },
      "maxItems": 16,
      "description": "Only integrations in one of these categories. Integrations without a category match no value."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "name"
      ],
      "description": "Sort by display name, with ties broken by integration name ascending."
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order. Defaults to asc."
    }
  },
  "additionalProperties": false,
  "description": "Arguments for the list_integrations tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Integration identifier"
          },
          "display_name": {
            "type": "string",
            "description": "Human-readable name"
          },
          "icon": {
            "type": [
              "string",
              "null"
            ],
            "description": "Icon filename (e.g., gmail.svg)"
          },
          "description": {
            "type": "string",
            "description": "Brief description of the integration"
          },
          "auth_type": {
            "type": "string",
            "enum": [
              "oauth2",
              "oauth1",
              "api-key",
              "basic"
            ]
          },
          "tool_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of available tools"
          },
          "prompt_count": {
            "type": "integer",
            "minimum": 0,
            "description": "Number of available prompts"
          },
          "icon_url": {
            "type": "string",
            "format": "uri",
            "description": "URL of the integration icon on the REST API"
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "description": "Connector category, such as communication. Null when the package declares none"
          },
          "availability": {
            "type": "string",
            "enum": [
              "default",
              "experimental",
              "host_adapter"
            ],
            "description": "Why this deployment publishes the integration: default, experimental or host_adapter"
          },
          "project_connections": {
            "type": "object",
            "properties": {
              "connected": {
                "type": "integer",
                "minimum": 0,
                "description": "Connections that are connected"
              },
              "expired": {
                "type": "integer",
                "minimum": 0,
                "description": "Connections whose credentials expired"
              },
              "disconnected": {
                "type": "integer",
                "minimum": 0,
                "description": "Connections that are disconnected"
              }
            },
            "required": [
              "connected",
              "expired",
              "disconnected"
            ],
            "additionalProperties": false,
            "description": "Shared connections of this integration in the projects the caller can see"
          },
          "project_user_connections": {
            "type": "object",
            "properties": {
              "connected": {
                "$ref": "#/properties/data/items/properties/project_connections/properties/connected",
                "description": "The connected returned by the tool."
              },
              "expired": {
                "$ref": "#/properties/data/items/properties/project_connections/properties/expired",
                "description": "The expired returned by the tool."
              },
              "disconnected": {
                "$ref": "#/properties/data/items/properties/project_connections/properties/disconnected",
                "description": "The disconnected returned by the tool."
              }
            },
            "required": [
              "connected",
              "expired",
              "disconnected"
            ],
            "additionalProperties": false,
            "description": "The caller's own connections of this integration. Zero for API keys and service credentials"
          }
        },
        "required": [
          "name",
          "display_name",
          "description",
          "auth_type",
          "tool_count",
          "prompt_count",
          "category",
          "availability",
          "project_connections",
          "project_user_connections"
        ],
        "additionalProperties": false
      },
      "description": "Primary result records returned by the tool."
    },
    "total": {
      "type": "integer",
      "minimum": 0,
      "description": "Total number of integrations matching the query"
    },
    "page_info": {
      "type": "object",
      "properties": {
        "self": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor that refers to the current page."
        },
        "first": {
          "type": "null"
        },
        "next": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor for the next page when pagination is available."
        },
        "prev": {
          "type": [
            "string",
            "null"
          ],
          "description": "Cursor for the previous page when pagination is available."
        }
      },
      "required": [
        "self",
        "first",
        "next",
        "prev"
      ],
      "additionalProperties": false,
      "description": "Pagination cursor values for traversing the result set."
    }
  },
  "required": [
    "data",
    "total",
    "page_info"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the list_integrations tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}