VeLeads Backend

The VeLeads backend is a NestJS API plus a standalone Hatchet worker (TypeScript, Prisma, Postgres). Data is organised into lists — each list owns its columns and its records, and everything is scoped to a workspace for multi-tenancy.

These docs focus on the MCP server: a Model Context Protocol endpoint that lets MCP clients (such as Claude Code) call VeLeads tools directly.

What the MCP server gives you

• A single streamable-HTTP endpoint: POST /mcp.
• Authentication with your existing workspace API key (vld_…) — no separate credential.
• Tools that reuse the same workspace-scoped services as the REST API, so behaviour is identical.

The first tool is research_company: point it at a list and it researches the companies in that list and writes the results back into a column on the table.

Where to go next

• MCP Server → Overview — how the endpoint is built and secured.
• MCP Server → Connect from Claude Code — get connected in one command.
• MCP Server → research_company — the tool reference.