Skip to content
/
List tools
Last updated

List Personal Connector Tools

🔨 In Development — This section is still being developed and may change.
Retrieve a list of all tools available from a specific personal connector configuration. These are the tools that AI assistants can use when this configuration is enabled.
GEThttps://api.freddy.aitronos.com/v1/personal-connectors/configurations/{config_id}/tools

This endpoint returns an array of tool definitions from the MCP server associated with this configuration. Tool definitions include the tool name, description, input schema, and other metadata that helps AI models understand how to use them.

Path Parameters

config_id string required The ID of the personal connector configuration (e.g., pconf_abc123).

Query Parameters

forceRefresh boolean optional · Defaults to false If true, bypasses the cache and fetches fresh tool definitions from the MCP server. Use this if you suspect the cache is stale.

Bash
curl https://api.freddy.aitronos.com/v1/personal-connectors/configurations/pconf_abc123/tools \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "name": "clickup_create_task",
      "description": "Create a new task in ClickUp within a specified list.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "list_id": {
            "type": "string",
            "description": "The ID of the ClickUp list where the task will be created."
          },
          "name": {
            "type": "string",
            "description": "The name or title of the new task."
          },
          "description": {
            "type": "string",
            "description": "A detailed description for the task."
          },
          "priority": {
            "type": "integer",
            "description": "The priority level of the task (e.g., 1-4).",
            "minimum": 1,
            "maximum": 4
          },
          "assignees": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of user IDs to assign to the task."
          }
        },
        "required": ["list_id", "name"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the newly created task."
          },
          "url": {
            "type": "string",
            "description": "URL to view the task in ClickUp."
          },
          "status": {
            "type": "string",
            "description": "The status of the created task."
          }
        }
      },
      "metadata": {
        "rateLimit": "100/minute",
        "costCategory": "high"
      }
    },
    {
      "name": "clickup_list_tasks",
      "description": "List tasks from a ClickUp list with optional filtering.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "list_id": {
            "type": "string",
            "description": "The ID of the ClickUp list."
          },
          "status": {
            "type": "string",
            "description": "Filter by task status."
          },
          "assignee": {
            "type": "string",
            "description": "Filter by assignee user ID."
          }
        },
        "required": ["list_id"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tasks": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Array of task objects."
          }
        }
      },
      "metadata": {
        "rateLimit": "100/minute",
        "costCategory": "medium"
      }
    }
  ],
  "cached": true,
  "cachedAt": "2025-10-07T10:45:00Z",
  "expiresAt": "2025-10-07T11:45:00Z"
}

Caching Behavior

Tool definitions are cached to improve performance and reduce load on MCP servers:

  • Cache Duration: Tools are cached for 1 hour by default
  • Auto-Refresh: Cache is automatically refreshed when expired
  • Manual Refresh: Use forceRefresh=true to bypass cache
  • Invalidation: Cache is invalidated when configuration is updated or toggled

The response includes cache metadata:

  • cached: Whether the response was served from cache
  • cachedAt: When the tools were cached
  • expiresAt: When the cache will expire

Tool Object Structure

Each tool in the response follows the Personal Connector Tool Object structure. See the object documentation for detailed field descriptions.

Previous page
Next page