# eve-mocks

> Mocks for eve agents

## Docs

- [Getting started](https://eve-mocks.vercel.app/): Four steps from an agent that calls production to an eval that runs offline.
- [Mocks](https://eve-mocks.vercel.app/mocks): Where an answer lives, then an MCP server or an HTTP API and its schema.
- [Evals](https://eve-mocks.vercel.app/evals): Mock files answer every eval. Pin a different answer when one assertion depends on it.
- [Allow](https://eve-mocks.vercel.app/allow): Allow the model gateway. Every other call is mocked or fails the run.
- [Authentication](https://eve-mocks.vercel.app/authentication): Sign-in is answered with mock-token. Write oauthToken when the token endpoint sends no grant_type.

## API Reference

- [defineMcpMock](https://eve-mocks.vercel.app/api/define-mcp-mock): Mock an MCP server from its pulled tool list and a result per tool.
- [defineHttpMock](https://eve-mocks.vercel.app/api/define-http-mock): Mock an HTTP API from pinned routes, an OpenAPI spec, or both.
- [mock](https://eve-mocks.vercel.app/api/mock): Pin what one operation answers for the sessions one eval starts.
- [seed](https://eve-mocks.vercel.app/api/seed): Set where one eval's sessions start on a stateful mock.
- [getState](https://eve-mocks.vercel.app/api/get-state): Read the state a session left on a stateful mock.
- [allow](https://eve-mocks.vercel.app/api/allow): Let requests to one real upstream through while the mocks are on.
- [oauthToken](https://eve-mocks.vercel.app/api/oauth-token): Mock an OAuth 2.0 token endpoint so client-credentials code receives mock-token.

## Reference

- [CLI](https://eve-mocks.vercel.app/cli): Every command, --json output, exit codes, and what coding agents can rely on.
- [FAQ](https://eve-mocks.vercel.app/faq): Requests that pass on their own, and the cases the basics do not cover.
- [Run in CI](https://eve-mocks.vercel.app/ci): One job, no services to start. The questions that come up are answered below.
- [Constraints](https://eve-mocks.vercel.app/constraints): What eve-mocks does not mock, and why.

## Agent resources

- [llms-full.txt](https://eve-mocks.vercel.app/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://eve-mocks.vercel.app/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://eve-mocks.vercel.app/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://eve-mocks.vercel.app/openapi.json.
- [API catalog](https://eve-mocks.vercel.app/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](https://eve-mocks.vercel.app/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://eve-mocks.vercel.app/sitemap.xml): Every indexable page URL with its last-modified date.