# Valjean Specialty agent API

> Valjean Specialty is a wholesale E&S insurance broker for retail agencies in South Carolina and Georgia. Its agent API and MCP connector let an agency's software or AI assistant check appetite, send submissions, answer what's needed, follow files, get quotes and ask to bind. A licensed Valjean broker reviews everything before it goes to a market, and nothing binds without a broker.

Base URL: https://api.valjeanspecialty.com/api/agent/v1 (Bearer API key from the agency portal). MCP connector: https://api.valjeanspecialty.com/api/mcp. Machine entry point: https://api.valjeanspecialty.com/.well-known/api-catalog

## Guides

- [Overview](https://docs.valjeanspecialty.com/guides/overview/): What the Valjean API does and how it fits with your Valjean broker.
- [Quickstart](https://docs.valjeanspecialty.com/guides/quickstart/): Check a key, check appetite and send your first file.
- [Authentication](https://docs.valjeanspecialty.com/guides/authentication/): API keys, scopes, OAuth for AI apps and revoking access.
- [For AI agents](https://docs.valjeanspecialty.com/guides/agents/): The whole workflow on one page, with the MCP tool and the REST call for each step.
- [Before you submit](https://docs.valjeanspecialty.com/guides/before-you-submit/): Appetite by class or NAICS, and the questions for a risk, with no file needed.
- [Sandbox](https://docs.valjeanspecialty.com/guides/sandbox/): Demo keys, the nightly reset, what's real and what isn't, and going live.
- [The flow](https://docs.valjeanspecialty.com/guides/flow/): From appetite to bind, step by step.
- [Answers and typed questions](https://docs.valjeanspecialty.com/guides/answers/): Answer by key once for every market, in the right shape.
- [Documents and uploads](https://docs.valjeanspecialty.com/guides/documents/): Upload small and large files, and download the paper.
- [Events and webhooks](https://docs.valjeanspecialty.com/guides/webhooks/): Follow every change on your files, by polling or by push.
- [Quotes and binding](https://docs.valjeanspecialty.com/guides/quotes-and-binding/): Presented quotes, and your written instruction to bind.
- [Instant quotes](https://docs.valjeanspecialty.com/guides/instant-quotes/): Ask markets connected by API for an instant price.
- [Conventions](https://docs.valjeanspecialty.com/guides/conventions/): Ids, money, dates, codes, idempotency, cursors and data scoping.
- [Errors](https://docs.valjeanspecialty.com/guides/errors/): Every error code, what it means, and whether to retry.
- [AI assistants (MCP)](https://docs.valjeanspecialty.com/guides/mcp/): Connect Claude and other assistants to Valjean as tools.
- [Command line](https://docs.valjeanspecialty.com/guides/cli/): The valjean CLI for scripts and testing.
- [Rules for AI agents](https://docs.valjeanspecialty.com/guides/rules-for-ai-agents/): How an AI assistant should use the Valjean API.

## Specs and skills

- [OpenAPI 3.1 spec](https://docs.valjeanspecialty.com/openapi.yaml): every operation, with x-agentic-access (what each call does, who has to act, how to undo it)
- [AsyncAPI spec for webhooks](https://docs.valjeanspecialty.com/asyncapi.yaml): every event and its payload
- [Agent skill](https://docs.valjeanspecialty.com/skills/valjean/SKILL.md): how an AI agent should use Valjean, step by step
- [API reference](https://docs.valjeanspecialty.com/api/): the same spec as pages