# Cala

> Cala is a knowledge API for publicly available information — query any real-world entity (organizations, people, events, laws, places, and more) and get structured, sourced JSON instead of web pages to parse.

Cala is ~9 percentage points more accurate than mainstream web-search providers and ~8× more token-efficient than parsing raw HTML — returning typed, verified JSON instead of web pages to parse.

## Getting Started

- [About Cala](https://docs.cala.ai/index.md): What Cala is, how it differs from web search, and when to use it
- [Quickstart](https://docs.cala.ai/quickstart.md): Get your API key and make your first request in 30 seconds
- [MCP Integration](https://docs.cala.ai/integrations/mcp.md): Connect Cala to Claude Desktop, Cursor, VS Code, or any MCP-compatible agent

## Core Tools

- [Knowledge Query](https://docs.cala.ai/features/knowledge-query.md): Structured dot-notation filter queries — use for "find all X where Y" (lists, comparisons, ranked results)
- [Knowledge Search](https://docs.cala.ai/features/knowledge-search.md): Natural language questions with cited answers — use for open-ended "what", "who", "explain" queries
- [Search Entities](https://docs.cala.ai/features/search-entities.md): Fuzzy name → UUID lookup — use to resolve a name before calling retrieve_entity
- [Retrieve Entity](https://docs.cala.ai/features/retrieve-entity.md): UUID → full typed profile with properties, relationships, and numerical observations

## API Reference

- [POST /v1/knowledge/query](https://docs.cala.ai/api-reference/api-v1/query.md): Structured filter endpoint — full parameter and response schema
- [POST /v1/knowledge/search](https://docs.cala.ai/api-reference/api-v1/search.md): Natural language search endpoint — full parameter and response schema
- [GET /v1/entities](https://docs.cala.ai/api-reference/api-v1/search-entities.md): Entity name search — all entity types and response schema
- [POST /v1/entities/{id}](https://docs.cala.ai/api-reference/entities.md): Retrieve entity by UUID — properties, relationships, numerical observations
- [GET /v1/entities/{id}/introspection](https://docs.cala.ai/api-reference/api-v1/entity-introspection.md): Discover queryable fields for an entity before calling retrieve_entity

## Optional

- [OpenAPI Spec](https://api.cala.ai/openapi.json)
- [API Console / Keys](https://console.cala.ai/api-keys)
- [Cala Homepage](https://cala.ai)
- [Support](mailto:heyeli@cala.ai)