list_catalog_entries

Instructions

Implementation Reference

• src/index.ts:126-135 (schema)

  Schema/registration of the 'list_catalog_entries' tool in the tools array, defining its name, description, and input schema (optional search filter).

  {
    name: "list_catalog_entries",
    description:
      "List MCP catalog entries available in obot's default catalog. Optional substring filter on name/id.",
    inputSchema: {
      type: "object",
      properties: { search: { type: "string" } },
      additionalProperties: false,
    },
  },

• src/index.ts:234-245 (handler)

  Handler implementation for 'list_catalog_entries'. Fetches catalog entries from /api/mcp-catalogs/default/entries, optionally filters by search substring, and returns id + name pairs.

  case "list_catalog_entries": {
    const data = await obotFetch("/api/mcp-catalogs/default/entries");
    let items: any[] = data.items ?? [];
    if (typeof args.search === "string" && args.search.length > 0) {
      const q = args.search.toLowerCase();
      items = items.filter((e) =>
        ((e.id ?? "") + " " + (e.manifest?.name ?? "")).toLowerCase().includes(q),
      );
    }
    const summary = items.map((e) => ({ id: e.id, name: e.manifest?.name }));
    return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
  }

• src/index.ts:54-136 (registration)

  The tools array containing all tool definitions, including list_catalog_entries at line 127. This array is registered as the tool list via ListToolsRequestSchema handler.

  const tools: Tool[] = [
    {
      name: "list_mcp_servers",
      description:
        "List MCP servers currently registered in obot. Returns id, name, runtime, configured-state, and the connectURL you'd hand to claude.ai.",
      inputSchema: { type: "object", properties: {}, additionalProperties: false },
    },
    {
      name: "get_mcp_server",
      description: "Get full details of one MCP server by id (including manifest, env, missingRequiredEnvVars).",
      inputSchema: {
        type: "object",
        properties: { id: { type: "string", description: "MCP server id, e.g. ms1mwrmr" } },
        required: ["id"],
        additionalProperties: false,
      },
    },
    {
      name: "add_npx_mcp",
      description:
        "Install a new MCP server in obot that runs as `npx <package>` (stdio). Use this for npm-published MCP servers.",
      inputSchema: {
        type: "object",
        properties: {
          name: { type: "string", description: "Display name shown in obot UI." },
          package: { type: "string", description: "npm package name, e.g. n8n-mcp or @scope/foo." },
          shortDescription: { type: "string" },
          env: {
            type: "object",
            description:
              "Env vars passed to the MCP process. Keys go in manifest.env[]. Mark secrets via sensitiveKeys.",
            additionalProperties: { type: "string" },
          },
          sensitiveKeys: {
            type: "array",
            items: { type: "string" },
            description: "Keys in `env` that should be marked sensitive (API keys, tokens).",
          },
          alias: {
            type: "string",
            description: "Optional short alias used in URLs/logs.",
          },
        },
        required: ["name", "package"],
        additionalProperties: false,
      },
    },
    {
      name: "add_remote_mcp",
      description: "Register a remote MCP server URL so obot proxies it. Use for HTTP/SSE MCPs hosted elsewhere.",
      inputSchema: {
        type: "object",
        properties: {
          name: { type: "string" },
          url: { type: "string", description: "Remote MCP endpoint URL." },
          shortDescription: { type: "string" },
          alias: { type: "string" },
        },
        required: ["name", "url"],
        additionalProperties: false,
      },
    },
    {
      name: "delete_mcp_server",
      description: "Delete an MCP server from obot by id. Irreversible.",
      inputSchema: {
        type: "object",
        properties: { id: { type: "string" } },
        required: ["id"],
        additionalProperties: false,
      },
    },
    {
      name: "list_catalog_entries",
      description:
        "List MCP catalog entries available in obot's default catalog. Optional substring filter on name/id.",
      inputSchema: {
        type: "object",
        properties: { search: { type: "string" } },
        additionalProperties: false,
      },
    },
  ];