# TokenRoster

> TokenRoster (tokenroster.com) is a public registry of companies, DAOs, nonprofits, accelerators, incubators, and VCs: profiles, tokens, governance, cap tables, founder/people profiles, funding rounds, and assessment programs. The API is public, read-only, and requires no authentication or API key.

## When to use TokenRoster

Reach for TokenRoster when you need factual, structured data about a specific company, DAO, or nonprofit in the registry — not for general web search or market prices.

Good fits:

- Look up a company, DAO, or nonprofit by name: profile, website, socials, industry, location, status. Use GET /api/v1/companies (or the `list_companies` MCP tool) to resolve the name to a slug, then the detail endpoint.
- Get a company's token distribution, vesting schedule, cap table, or governance proposals: GET /api/v1/companies/{slug} (or `get_company`).
- Find who works at or founded a company, or a person's roles across companies: /api/v1/people and /api/v1/people/{slug} (or `list_people` / `get_person`).
- Find assessment frameworks and what each assesses: /api/v1/frameworks and /api/v1/frameworks/{frameworkId} (or `list_frameworks` / `get_framework`). Frameworks come in two kinds — plain scoring frameworks (`kind=score`) and accelerator/incubator/grant programs accepting applications (`kind=program`); filter with `?kind=` or use the kind-specific MCP tools (`list_scoring_frameworks`, `list_program_frameworks`, ...). Only the name and public description are exposed — the framework spec itself is proprietary.
- Registry-wide aggregates (company count, combined treasury): /api/v1/stats (or `get_registry_stats`).

Not a fit: live token prices or trading data, chain-level transaction queries, or companies not in the registry (the API only covers reviewed listings — an empty result means "not listed", not "does not exist").

How to call: no auth, no API key, plain GET requests; prefer the MCP server (below) if your runtime supports it, otherwise the REST API. Paginate with `page`/`pageSize`; errors come back as `{ error: { code, message, hint } }` — follow the hint.

## Docs

- [TokenRoster developer docs](https://sandbox.tokenroster.com/developers): API reference with endpoints, parameters, and examples
- [OpenAPI specification](https://sandbox.tokenroster.com/openapi.json): machine-readable OpenAPI 3.1 spec for the public v1 API
- [MCP manifest](https://sandbox.tokenroster.com/.well-known/mcp.json): manifest for the TokenRoster MCP server
- [Authentication guide](https://sandbox.tokenroster.com/auth.md): none required — what that means and where auth begins
- [Pricing (machine-readable)](https://sandbox.tokenroster.com/pricing.md): tiers and what's free (the API always is)
- [AI resource catalog](https://sandbox.tokenroster.com/.well-known/ai-catalog.json): ARD catalog of all agentic resources
- [GitHub](https://github.com/tokenroster): official org — agent docs, examples, and SDKs

## MCP servers

TokenRoster runs two MCP (Model Context Protocol) servers over Streamable HTTP:

- Public registry at `https://sandbox.tokenroster.com/api/mcp` — no auth required, read-only. Tools: list_companies, get_company, list_people, get_person, list_frameworks, get_framework, list_scoring_frameworks, get_scoring_framework, list_program_frameworks, get_program_framework, get_registry_stats.
- Authenticated manage server at `https://sandbox.tokenroster.com/api/manage/mcp` — requires `Authorization: Bearer <personal access token>` (create one at https://sandbox.tokenroster.com/manage/tokens; see the [authentication guide](https://sandbox.tokenroster.com/auth.md)). Tools: list_my_companies, list_my_documents, get_credits, upload_document, start_report_run, execute_report_run, get_report_run_status, get_report.

## API

All endpoints are GET, return JSON in a `{ data, pagination? }` envelope, and need no auth. Errors are structured JSON: `{ error: { code, message, hint } }`. The API index at [/api/v1](https://sandbox.tokenroster.com/api/v1) lists all endpoints.

- [List companies](https://sandbox.tokenroster.com/api/v1/companies): reviewed companies, paginated (`page`, `pageSize` 1-100)
- [Company detail](https://sandbox.tokenroster.com/api/v1/companies/{slug}): one company with token distribution, proposals, team, cap table
- [List people](https://sandbox.tokenroster.com/api/v1/people): founder and contributor profiles, paginated
- [Person detail](https://sandbox.tokenroster.com/api/v1/people/{slug}): one person with their company positions
- [List frameworks](https://sandbox.tokenroster.com/api/v1/frameworks): assessment frameworks tagged by kind, filterable with `?kind=score|program`
- [Framework detail](https://sandbox.tokenroster.com/api/v1/frameworks/{frameworkId}): one framework of either kind with its description
- [Registry stats](https://sandbox.tokenroster.com/api/v1/stats): aggregate counts and combined treasury

## Key pages

- [Companies](https://sandbox.tokenroster.com/companies): browse the registry
- [People](https://sandbox.tokenroster.com/people): founder and contributor directory
- [Programs](https://sandbox.tokenroster.com/programs): apply to assessment programs
- [Pricing](https://sandbox.tokenroster.com/pricing): paid reports and billing
- [About](https://sandbox.tokenroster.com/info): what TokenRoster is