FruxonDocs
IntegrationsTools

Imports tools from a remote MCP server into an integration.

The integration is created automatically if it does not yet exist. Tools that already exist within the integration are skipped unless `overrideExisting` is set.

POST
/v1/tenants/{tenant}/integrations:importMcp

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Request Body

The MCP server URL and optional configuration.

serverUrl*string|null

Base URL of the MCP server (Streamable HTTP endpoint).

integrationId?string|null

ID for the integration. Derived from the server hostname when omitted.

displayName?string|null

Display name for the integration. Derived from the server hostname when omitted.

bearerToken?string|null

Optional bearer token forwarded to the MCP server during import.

overrideExisting?boolean

When true, updates the integration and any existing tools instead of skipping them. Defaults to false (skip existing).

[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/integrations:importMcp" \  -H "Content-Type: application/json" \  -d '{    "serverUrl": "string"  }'
{
  "integration": {
    "id": "string",
    "displayName": "string",
    "description": "string",
    "type": "SYSTEM",
    "configMetadata": {
      "parametersMetadata": [],
      "authMetadata": [
        null
      ]
    },
    "tags": [
      "string"
    ],
    "isInternal": false,
    "createdAt": 0,
    "modifiedAt": 0
  },
  "tools": [
    {
      "descriptor": {
        "apiTool": null,
        "predefinedTool": null,
        "mcpTool": null,
        "codeTool": null
      },
      "isInternal": false,
      "createdAt": 0,
      "id": "string",
      "modifiedAt": 0,
      "integrationId": "string",
      "displayName": "string",
      "description": "string",
      "toolType": "API",
      "isModifiable": true,
      "actionType": "READ_ONLY",
      "resultType": "UNSPECIFIED",
      "parametersMetadata": [],
      "authSettings": {
        "supportsOAuth": false,
        "oAuth": []
      }
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
Empty

Updates an existing skill.

Full replace of the mutable fields on the skill. Agents that have this skill attached pick up the new instructions on their next turn — there is no per-conversation pinning. Built-in skills cannot be updated and will return 404.

Lists AI Tools with optional filtering, search, and pagination.

Returns a paginated list of tools registered under the integration that match the optional type and search filters, with pricing metadata attached. Use `search` for case-insensitive substring matching against tool ID, display name, and description. Use `page_size`/`page_token` to page through results.