# Bika.ai — how to use (mcp.ai)

Connect your Bika.ai account and use 8 tools for databases straight from your AI agent. Connect with your own API key. Bika.ai is an AI automation database platform for managing spaces, teams, records, automations, and outgoing webhooks.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_bika?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `bika_create_records`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/bika`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/bika/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/bika/create/records` — Create one to ten records in a Bika database in one request and return every created record ID and field value.
  - body: { records: object[], space_id: string, field_key?: string, database_id: string }
- `POST https://api.mcp.ai/api/bika/delete/records` — Permanently delete one to ten explicitly identified records from a Bika database and return a deletion result for each ID. This deletion is permanent.
  - body: { space_id: string, record_ids: string[], database_id: string }
- `POST https://api.mcp.ai/api/bika/get/database/schema` — Get a Bika database's metadata, views, and field definitions, including the field IDs needed to read and write records by ID.
  - body: { space_id: string, database_id: string }
- `POST https://api.mcp.ai/api/bika/get/record` — Get one Bika record by ID, with field values keyed by field name or field ID.
  - body: { space_id: string, field_key?: string, record_id: string, database_id: string }
- `POST https://api.mcp.ai/api/bika/list/nodes` — List the nodes in a Bika space so an agent can discover database and automation resource IDs by name, type, and path.
  - body: { space_id: string }
- `POST https://api.mcp.ai/api/bika/list/records` — Return one cursor-controlled page of records from a Bika database, optionally selecting specific fields by name or ID.
  - body: { fields?: string[], space_id: string, field_key?: string, page_size?: integer, database_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/bika/list/spaces` — List spaces available to the connected Bika account and return the space IDs needed by database tools.
- `POST https://api.mcp.ai/api/bika/update/records` — Update fields on one to ten existing Bika records in one request and return the updated records.
  - body: { records: object[], space_id: string, field_key?: string, database_id: string }

## Example prompts
- "What can I do in Bika.ai?"
- "Show me a summary of my Bika.ai account"

## More
- Page: https://mcp.ai/bika
- Agent spec (llms.txt): https://mcp.ai/bika/llms.txt
- Postman collection: https://mcp.ai/bika/postman.json