# ApptiveGrid — how to use (mcp.ai)

Connect your ApptiveGrid account and use 7 tools for databases straight from your AI agent. Connect with your own API key. ApptiveGrid is a collaborative no-code database and app platform for managing spaces, grids, forms, and structured records.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_apptivegrid?ms=1787293500000`
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. `apptivegrid_create_record`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/apptivegrid`
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/apptivegrid/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/apptivegrid/create/record` — Create one record in a grid from a provider-native object keyed by that grid's field IDs or field keys; inspect the grid first to construct valid values.
  - body: { record: object, grid_id: string, user_id: string, space_id: string }
- `POST https://api.mcp.ai/api/apptivegrid/get/current/user` — Return the connected ApptiveGrid user's ID, plan, seat availability, and resource links; use it to identify the user before listing spaces.
- `POST https://api.mcp.ai/api/apptivegrid/get/grid` — Return a grid's metadata and dynamic field definitions; use it before listing, reading, or creating records.
  - body: { grid_id: string, user_id: string, space_id: string }
- `POST https://api.mcp.ai/api/apptivegrid/get/record` — Return one record from a grid by record ID, optionally rendered with a provider layout.
  - body: { layout?: string, grid_id: string, user_id: string, space_id: string, record_id: string }
- `POST https://api.mcp.ai/api/apptivegrid/get/space` — Return a space and its grid summaries or grid links; use it to discover grid IDs before reading records.
  - body: { user_id: string, space_id: string }
- `POST https://api.mcp.ai/api/apptivegrid/list/records` — Return one 1-based page of records from a grid, optionally using the provider's layout, filter, and sorting definitions.
  - body: { filter?: object, layout?: string, grid_id: string, sorting?: object[], user_id: string, space_id: string, page_size?: integer, page_index?: integer }
- `POST https://api.mcp.ai/api/apptivegrid/list/spaces` — Return one 1-based page of spaces available to a user, including IDs needed to inspect a space.
  - body: { user_id: string, page_size?: integer, page_index?: integer }

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

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