Kiodo

JavaScript SDK and stdio MCP server for Kiodo Search, URL fetching, grounded answers, usage checks, and AI Visibility beta.

Install

npm install kiodo

Run the stdio MCP server directly with:

npx -y kiodo

Websets and monitors are private-beta configuration tools only. They do not execute runs, expose run history, deliver webhooks, or return result logs yet.

SDK

import { Kiodo } from "kiodo";

const kiodo = new Kiodo({ apiKey: process.env.KIODO_API_KEY });

const results = await kiodo.search({
  query: "best payroll APIs for startups",
  numResults: 5,
});

const pages = await kiodo.fetchContents({
  urls: ["https://example.com/research"],
});

const answer = await kiodo.answer({
  query: "Which payroll APIs are best for seed-stage US startups?",
  numResults: 5,
});

const usage = await kiodo.usage();

const visibility = await kiodo.aiVisibility.check({
  brand: "Acme",
  category: "payroll API",
  market: "us",
  competitors: ["Gusto", "Check"],
});

AI Visibility requires beta/pro access, AI_VISIBILITY_ENABLED=true on the API environment, and an API key with ai_visibility:read.

Websets and monitors are private-beta configuration APIs:

await kiodo.websets.create({
  query: "US AI payroll startups",
  count: 10,
});

await kiodo.monitors.create({
  query: "AI payroll funding news",
  interval: "1d",
});

MCP

node packages/kiodo-mcp-server/bin/kiodo.js

Set credentials in the MCP client environment:

KIODO_API_KEY="kiodo_live_..."
KIODO_API_BASE_URL="https://kiodo.dev"
KIODO_TIMEOUT_MS="30000"

KIODO_API_BASE_URL defaults to https://kiodo.dev. KIODO_TIMEOUT_MS defaults to 30000.

Tool Selection

By default, the stdio server exposes:

• kiodo_search
• kiodo_fetch
• kiodo_answer
• kiodo_usage

Enable private-beta configuration tools explicitly:

KIODO_MCP_TOOLS="kiodo_search,kiodo_fetch,kiodo_answer,kiodo_usage,kiodo_create_webset,kiodo_create_monitor" node packages/kiodo-mcp-server/bin/kiodo.js

The server validates tool arguments before calling the Kiodo API and returns MCP -32602 errors for missing required fields, invalid enum values, and out-of-range numeric inputs.

Claude Desktop

{
  "mcpServers": {
    "kiodo": {
      "command": "node",
      "args": ["packages/kiodo-mcp-server/bin/kiodo.js"],
      "env": {
        "KIODO_API_KEY": "kiodo_live_...",
        "KIODO_API_BASE_URL": "https://kiodo.dev",
        "KIODO_TIMEOUT_MS": "30000"
      }
    }
  }
}