# Kinobi — Company Intelligence API

> Search 500+ companies by tech stack, signals, funding, leadership, and more.
> Used by sales and GTM teams to find and qualify prospects.

Kinobi provides structured, verified company intelligence for AI agents and sales teams. It covers tech stacks, org charts, hiring signals, funding history, and warm relationship paths.

## Instructions for AI assistants

All Kinobi API endpoints are plain HTTPS GET requests — no special client needed.

- **Claude**: use the `webfetch` tool to call API URLs directly
- **ChatGPT**: use the `browser` tool with `open_url()` to call API URLs directly
- All endpoints return JSON. Pass the Bearer token as a URL-safe header where supported, or ask the user to confirm once authenticated.

## Capabilities

- **Search**: Natural language queries across companies ("fintech using Salesforce", "companies migrating off Oracle")
- **Signals**: Leadership changes, funding rounds, hiring surges, tech shifts
- **Tech stack**: What tools a company uses, with confidence scores and source
- **People**: Decision-makers, C-suite, org hierarchy
- **Warm paths**: Relationship graph — who knows whom

## Authentication

Pass your API key as: `Authorization: Bearer {your_api_key}`

## Search API

```
GET https://api.kinobi.so/v2/search?q={query}&limit=20
Authorization: Bearer {token}
```

The query is natural language — the API uses an AI planner internally to handle complex, multi-criteria queries.

**Example queries:**
- `?q=enterprise+companies+using+ServiceNow+with+recent+leadership+changes`
- `?q=fintech+startups+in+Germany+that+raised+Series+B+in+the+last+12+months`
- `?q=SaaS+companies+using+Kubernetes+with+a+hiring+surge+in+engineering`
- `?q=competitors+of+Salesforce+that+recently+raised+funding`
- `?q=companies+migrating+off+Oracle`

**Response shape:**
```json
{
  "query": "...",
  "results": [
    {
      "name": "Acme Corp",
      "domain": "acme.com",
      "industry": "Enterprise Software",
      "employee_count": 5000,
      "hq_location": "San Francisco, CA",
      "country": "US",
      "rrf_score": 0.85
    }
  ],
  "total": 12
}
```

## MCP (Model Context Protocol)

For persistent connections, Kinobi also supports MCP via Streamable HTTP:

```
Server URL: https://api.kinobi.so/mcp
Authorization: Bearer {token}
```

**Claude Desktop** — add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "kinobi": {
      "url": "https://api.kinobi.so/mcp",
      "headers": { "Authorization": "Bearer {token}" }
    }
  }
}
```

**Available MCP tools:** `search`, `get_company_dossier`, `enrich_company`, `get_signals`, `find_warm_path`, `list_companies`

## Links

- Website: https://kinobi.so
- Full API docs: https://api.kinobi.so/docs
- Contact: me@ankitpansari.com