Consultar lista de Tool / MCP

Permite consultar la lista de Tool y MCP de una organización específica.

Mediante esta interfaz, se puede consultar la lista de Tool y MCP de una organización específica.

Método de solicitud

GET

URL de la solicitud

https://api.${endpoint}/v1/org/tool/list

Autenticación de la solicitud

Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta.

Solicitud

Ejemplo de solicitud

curl -X GET 'https://api.${endpoint}/v1/org/tool/list?org_id=p-xxxx&plugin_type=TOOL&available=true&keyword=weather' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/org/tool/list?org_id=p-xxxx&plugin_type=TOOL&available=true&keyword=weather' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Basic ${BASIC_TOKEN}	Basic Token resultante de codificar `DevKey:DevSecret` en Base64.

Parámetros de la solicitud (Query Parameters)

Campo	Tipo	Descripción	Obligatorio
org_id	String	ID de la organización.	true
keyword	String	Palabra clave; filtra por nombre o descripción.	false
plugin_type	String	Tipo de recurso; admite `TOOL`, `MCP`; si no se indica, se devuelven Tool y MCP.	false
available	Boolean	Indica si solo se devuelven los recursos disponibles o no disponibles.	false

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK", "data": [ { "resource_id": "tool-xxxx", "name": "weather", "display_name": "Weather Lookup", "description": "Query current weather", "logo": "https://cdn.example.com/weather.png", "url": "https://api.example.com", "plugin_type": "TOOL", "available": true, "action_count": 2, "create_time": 1785826041000, "update_time": 1785826041000 } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "resource_id": "tool-xxxx",
      "name": "weather",
      "display_name": "Weather Lookup",
      "description": "Query current weather",
      "logo": "https://cdn.example.com/weather.png",
      "url": "https://api.example.com",
      "plugin_type": "TOOL",
      "available": true,
      "action_count": 2,
      "create_time": 1785826041000,
      "update_time": 1785826041000
    }
  ]
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
resource_id	String	ID del Tool o MCP.
name	String	Nombre del recurso.
display_name	String	Nombre de visualización.
description	String	Descripción.
logo	String	URL del icono.
url	String	Dirección del servicio.
plugin_type	String	Tipo de recurso, `TOOL` o `MCP`.
available	Boolean	Indica si está disponible.
action_count	Integer	Número de Actions.
create_time	Long	Hora de creación, marca de tiempo en milisegundos.
update_time	Long	Hora de actualización, marca de tiempo en milisegundos.

Respuesta fallida

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes
429	Demasiadas solicitudes
500	Error del servidor