# Wihyu

> Wihyu finds companies matching a customer's Ideal Customer Profile (ICP) based on job-posting activity, for sales and marketing outreach.

- [API docs](https://api.wihyu.com/v1/docs): the full REST API reference.
- [MCP server](https://api.wihyu.com/v1/mcp): tools for searching companies, managing the ICP, and setup.
- [Authentication](https://api.wihyu.com/auth.md): OAuth, API keys, and the anonymous onboarding call.

## Use MCP for all interactions

Agents should use the [MCP server](https://api.wihyu.com/v1/mcp) for all Wihyu reads and writes rather than scraping or guessing REST endpoints. Connect over streamable HTTP with `Authorization: Bearer <OAuth token or wk_ API key>`, call `initialize`, then `tools/list`. See [/auth.md](https://api.wihyu.com/auth.md) for a client configuration example.

## Onboard a new tenant

An agent can request a new Wihyu account on a customer's behalf with no credential at all: `POST https://api.wihyu.com/v1/tenant-requests` (an authenticated MCP client can use the `create_tenant_request` tool instead). A Wihyu admin reviews and approves every request; once approved, Wihyu emails the account owner a one-time consent link, and after they press Allow your agent receives an API key once in the status poll (`owner_consent` shows where consent stands). See [/auth.md](https://api.wihyu.com/auth.md) for the full sequence, including polling for status and completing ICP setup. Clients that support the MCP Tasks extension (`io.modelcontextprotocol/tasks`) can use it for the same flow.
