# Refolk API and MCP server

> Search for people programmatically. Two searches, one account, one credit balance. Authenticate with `Authorization: Bearer rfk_live_...`; keys are created at https://www.refolk.ai/hire/api.

Canonical page: https://www.refolk.ai/developers

## Documentation

- [Quickstart](https://www.refolk.ai/developers/quickstart.md): Create a key, run your first search, and read what comes back. A working request in under two minutes, in curl, TypeScript, and Python.
- [Authentication](https://www.refolk.ai/developers/authentication.md): How API keys work: creating one, sending it, rotating it, and what happens when one leaks. Keys are shown once and hashed at rest.
- [Credits and limits](https://www.refolk.ai/developers/credits-and-limits.md): What each call costs, how a search is reserved and reconciled, what the rate limits are, and how to check a balance before a long run.
- [Playground](https://www.refolk.ai/developers/playground.md): Run any endpoint from the browser, signed in, on your own credits. Prefilled examples, the real response, and the equivalent curl for your own code.
- [Search in plain English](https://www.refolk.ai/developers/agentic-search.md): POST /v1/search. One sentence in, a ranked shortlist out, with the evidence behind every pick. Blocking or streamed as server-sent events.
- [Search with filters](https://www.refolk.ai/developers/structured-search.md): POST /v1/people/search. An exact filter set in, a deterministic page of people out, one credit a call. Every field, every allowed value, and how to paginate.
- [Errors](https://www.refolk.ai/developers/errors.md): One error shape for every endpoint, a closed set of types, and which of them are worth retrying. What gets refunded when a call fails.
- [MCP server](https://www.refolk.ai/developers/mcp.md): Give Claude, Cursor, VS Code, or any MCP client the ability to search for people mid-conversation. One URL, one header, four tools.

## MCP client setup

- [Claude Code](https://www.refolk.ai/developers/mcp/claude-code.md): One command. Search for people from the terminal you are already in.
- [Cursor](https://www.refolk.ai/developers/mcp/cursor.md): Add it once to mcp.json and every chat in the editor can search.
- [Claude Desktop](https://www.refolk.ai/developers/mcp/claude-desktop.md): Search for people inside a normal Claude conversation.
- [VS Code](https://www.refolk.ai/developers/mcp/vs-code.md): Copilot's agent mode gets four tools and a real people index.
- [Windsurf](https://www.refolk.ai/developers/mcp/windsurf.md): Cascade can find the people, not just the code.
- [Cline](https://www.refolk.ai/developers/mcp/cline.md): Add a remote server from the MCP pane and keep working.

## Machine-readable

- [OpenAPI document](https://www.refolk.ai/api/v1/openapi.json): every endpoint, request and response shape.
- [MCP endpoint](https://www.refolk.ai/api/mcp): Streamable HTTP, 4 tools.