# CiteTrue

> Verify and find academic citations programmatically. Detects AI-hallucinated references and broken DOIs; searches Crossref, OpenAlex, Semantic Scholar, PubMed, arXiv, and more.

## Docs

- [API reference (LLM-friendly)](https://citetrue.com/docs/api.md): complete API docs in plain markdown — endpoints, SSE event shapes, assessment values, credit costs, error codes.
- [API reference (HTML)](https://citetrue.com/docs/api): same content as above, with interactive ToC and code-block highlighting.
- [MCP server (LLM-friendly)](https://citetrue.com/docs/mcp.md): `@citetrue/mcp-server` — wraps the API as MCP tools for Claude Desktop, Cursor, etc.
- [MCP server (HTML)](https://citetrue.com/docs/mcp): setup instructions, client configs, tool reference.
- [Guides](https://citetrue.com/docs/guides): user-facing how-tos — getting started, supported citation formats, understanding results, deep verify, FAQ.

## Endpoints

- Base URL: `https://api.citetrue.com`
- `POST /verify/v2`: split text into refs and verify each. Modes: `text`, `refHash`+`parentTaskHash` (deeper-depth upgrade), or `taskHash` (resume). Streams SSE.
- `POST /find/v1`: find papers that back up the claims in a piece of text. Streams SSE.
- `GET /credits`: current credit balance for the account.
- `GET /credit-rules`: machine-readable cost table (unauthenticated).

## MCP

- Package: `@citetrue/mcp-server` (npm)
- Transport: stdio
- Tools: `verify`, `find`, `get_credits`
- Auth: `CITETRUE_API_KEY` env var (same API key as the REST API).