veryfront__get_integrationsalesforce__update_case.
Use list_integrations to discover available integrations.
With project_reference and tool_name, also return a private metadata-only selection assessment; provider permissions remain unverified.
Supply project_reference and tool_name together.
connection_id requires tool_name; expected_connection_generation_id also requires connection_id.
The server validates these cross-field requirements in addition to the JSON Schema.
Returned credential scopes are project or user; the legacy endUser input is normalized to user.
Access
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
tool_name | string | No | Canonical integration__tool_id to inspect using metadata only. Minimum length: 1. Maximum length: 256. |
connection_id | string | No | Explicit visible OAuth connection. Requires tool_name. Format: uuid. |
expected_connection_generation_id | string | No | Observed connection generation. Requires tool_name and connection_id. Format: uuid. |
project_reference | string | No | Explicit project UUID or slug. Requires tool_name; selected readiness requires authentication. Minimum length: 1. |
name | string | Yes | Integration name from list_integrations. For a tool ID such as salesforce__update_case, use the namespace before ”__”. |
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.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__get_integration",
"arguments": {
"name": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
name | string | Yes | Integration identifier |
display_name | string | Yes | Human-readable name |
icon | string or null | No | Icon filename (e.g., gmail.svg) |
description | string | Yes | Brief description of the integration |
auth | object | Yes | Authentication configuration |
env_vars | object[] | Yes | Required environment variables |
tools | object[] | Yes | Available tools provided by this integration |
prompts | object[] | Yes | Available prompts provided by this integration |
suggested_with | string[] or null | No | Related integrations that work well with this one |
config_schema | object or null | No | Optional integration configuration schema for project-level governance settings |
selected_readiness | object | No |
Full schemas
{
"type": "object",
"properties": {
"tool_name": {
"type": "string",
"minLength": 1,
"maxLength": 256,
"description": "Canonical integration__tool_id to inspect using metadata only."
},
"connection_id": {
"type": "string",
"format": "uuid",
"description": "Explicit visible OAuth connection. Requires tool_name."
},
"expected_connection_generation_id": {
"type": "string",
"format": "uuid",
"description": "Observed connection generation. Requires tool_name and connection_id."
},
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Explicit project UUID or slug. Requires tool_name; selected readiness requires authentication."
},
"name": {
"type": "string",
"description": "Integration name from list_integrations. For a tool ID such as salesforce__update_case, use the namespace before \"__\"."
}
},
"required": [
"name"
],
"additionalProperties": false,
"description": "Arguments for the get_integration tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"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": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"oauth2",
"oauth1",
"api-key",
"basic"
]
},
"provider": {
"type": [
"string",
"null"
],
"description": "OAuth provider name"
},
"scopes": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
},
"description": "List of scopes associated with this tool result."
},
{
"type": "null",
"description": "The scopes returned by the tool."
}
],
"description": "Required OAuth scopes"
}
},
"required": [
"type"
],
"additionalProperties": false,
"description": "Authentication configuration"
},
"env_vars": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Environment variable name"
},
"description": {
"type": "string",
"description": "Description of the variable"
},
"required": {
"type": "boolean",
"description": "Whether this variable is required"
},
"sensitive": {
"type": "boolean",
"description": "Whether this variable contains sensitive data"
}
},
"required": [
"name",
"description",
"required",
"sensitive"
],
"additionalProperties": false
},
"description": "Required environment variables"
},
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Tool identifier"
},
"name": {
"type": "string",
"description": "Tool name"
},
"description": {
"type": "string",
"description": "Tool description"
},
"input_schema": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "JSON Schema for callable tool input. Omitted when the catalog tool is not callable."
}
},
"required": [
"id",
"name",
"description"
],
"additionalProperties": false
},
"description": "Available tools provided by this integration"
},
"prompts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Prompt identifier"
},
"title": {
"type": "string",
"description": "Prompt title"
},
"prompt": {
"type": "string",
"description": "Prompt template text"
}
},
"required": [
"id",
"title",
"prompt"
],
"additionalProperties": false
},
"description": "Available prompts provided by this integration"
},
"suggested_with": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
},
"description": "List of suggested with associated with this tool result."
},
{
"type": "null",
"description": "The suggested with returned by the tool."
}
],
"description": "Related integrations that work well with this one"
},
"config_schema": {
"anyOf": [
{
"type": "object",
"properties": {
"version": {
"type": "number",
"const": 1
},
"fields": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"type": {
"type": "string",
"const": "select"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
},
"default": {
"type": "string"
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
}
},
"required": [
"value",
"label"
],
"additionalProperties": false
},
"description": "List of options associated with this tool result."
}
},
"required": [
"key",
"type",
"label",
"options"
],
"additionalProperties": false,
"description": "Structured option 1 details associated with this tool result."
},
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"type": {
"type": "string",
"const": "multiselect"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
},
"default": {
"type": "array",
"items": {
"type": "string"
}
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
}
},
"required": [
"value",
"label"
],
"additionalProperties": false
},
"description": "List of options associated with this tool result."
}
},
"required": [
"key",
"type",
"label",
"options"
],
"additionalProperties": false,
"description": "Structured option 2 details associated with this tool result."
},
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"type": {
"type": "string",
"const": "boolean"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
},
"default": {
"type": "boolean"
}
},
"required": [
"key",
"type",
"label"
],
"additionalProperties": false,
"description": "Structured option 3 details associated with this tool result."
},
{
"type": "object",
"properties": {
"key": {
"type": "string"
},
"type": {
"type": "string",
"const": "number"
},
"label": {
"type": "string"
},
"description": {
"type": "string",
"description": "Human-readable description returned by the tool."
},
"default": {
"type": "number"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"step": {
"type": "number"
}
},
"required": [
"key",
"type",
"label"
],
"additionalProperties": false,
"description": "Structured option 4 details associated with this tool result."
}
]
},
"description": "Fields returned for the structured input request."
}
},
"required": [
"version",
"fields"
],
"additionalProperties": false,
"description": "Structured config schema details associated with this tool result."
},
{
"type": "null",
"description": "The config schema returned by the tool."
}
],
"description": "Optional integration configuration schema for project-level governance settings"
},
"selected_readiness": {
"type": "object",
"properties": {
"version": {
"type": "number",
"const": 1
},
"selection": {
"type": "object",
"properties": {
"integration": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"selected",
"missing",
"ambiguous",
"unavailable",
"stale",
"unknown"
]
},
"mode": {
"type": "string",
"enum": [
"oauth_connection",
"project_credentials",
"service_identity",
"mock",
"unknown"
]
},
"scope": {
"anyOf": [
{
"type": "string",
"enum": [
"user",
"project"
]
},
{
"type": "null",
"description": "The scope returned by the tool."
}
]
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project identifier associated with this result."
},
"tool_name": {
"type": "string"
},
"requested_connection_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null",
"description": "The requested connection id returned by the tool."
}
]
},
"connection_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null",
"description": "The connection id returned by the tool."
}
]
},
"connection_generation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null",
"description": "The connection generation id returned by the tool."
}
]
}
},
"required": [
"integration",
"state",
"mode",
"scope",
"project_id",
"tool_name",
"requested_connection_id",
"connection_id",
"connection_generation_id"
],
"additionalProperties": false,
"description": "Structured selection details associated with this tool result."
},
"connection": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"connected",
"expired",
"disconnected",
"revoked",
"missing",
"unknown",
"not_applicable"
]
}
},
"required": [
"state"
],
"additionalProperties": false,
"description": "Structured connection details associated with this tool result."
},
"account": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"recorded",
"unknown"
]
},
"id": {
"type": [
"string",
"null"
],
"description": "Unique identifier for the returned record."
},
"evidence": {
"type": "string",
"enum": [
"stored_metadata",
"none"
]
},
"display_name": {
"type": [
"string",
"null"
]
}
},
"required": [
"state",
"id",
"evidence",
"display_name"
],
"additionalProperties": false,
"description": "Structured account details associated with this tool result."
},
"credentials": {
"type": "object",
"properties": {
"evidence": {
"type": "string",
"enum": [
"connection_metadata",
"complete_key_presence",
"partial_key_presence",
"absent",
"not_applicable"
]
},
"missing_keys": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of missing keys associated with this tool result."
}
},
"required": [
"evidence",
"missing_keys"
],
"additionalProperties": false,
"description": "Structured credentials details associated with this tool result."
},
"local_eligibility": {
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"eligible",
"blocked",
"unknown"
]
},
"basis": {
"type": "string",
"const": "metadata_only"
},
"blockers": {
"type": "array",
"items": {
"type": "string",
"enum": [
"tool_unavailable",
"tool_permission_denied",
"connection_required",
"connection_selection_required",
"connection_unavailable",
"connection_stale",
"reconnect_required",
"credentials_missing",
"technical_configuration_blocked",
"selector_incompatible_with_mode"
]
},
"description": "List of blockers associated with this tool result."
},
"required_capability": {
"type": "string",
"enum": [
"project.integrations.read",
"project.integrations.connect"
]
},
"pending_checks": {
"type": "array",
"items": {
"type": "string",
"enum": [
"argument_validation",
"credential_value_validation",
"provider_authorization",
"credential_mode_resolution",
"mock_tool_availability",
"provider_resource_validation"
]
},
"description": "List of pending checks associated with this tool result."
}
},
"required": [
"state",
"basis",
"blockers",
"required_capability",
"pending_checks"
],
"additionalProperties": false,
"description": "Structured local eligibility details associated with this tool result."
},
"provider_verification": {
"type": "object",
"properties": {
"state": {
"type": "string",
"const": "not_checked"
}
},
"required": [
"state"
],
"additionalProperties": false,
"description": "Structured provider verification details associated with this tool result."
}
},
"required": [
"version",
"selection",
"connection",
"account",
"credentials",
"local_eligibility",
"provider_verification"
],
"additionalProperties": false
}
},
"required": [
"name",
"display_name",
"description",
"auth",
"env_vars",
"tools",
"prompts"
],
"additionalProperties": false,
"description": "Structured result returned by the get_integration tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}