# 21risk — how to use (mcp.ai)

Connect your 21risk account and use 8 tools for business intelligence straight from your AI agent. Connect with your own API key. 21RISK is a web application that simplifies working with checklists, audits, and actions, facilitating compliance and risk management processes.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/_21risk/get/compliance` — Tool to retrieve compliance data for sites, categories, or questions. Use when you need OData-based compliance data for analytics or reporting.
  - body: { top?: integer, skip?: integer, count?: boolean, expand?: string, filter?: string, select?: string, orderby?: string, skiptoken?: string, _maxPageSizeInMb?: integer }
- `POST https://api.mcp.ai/api/_21risk/get/items` — Tool to retrieve items (BETA) from the 21RISK OData API. Use when you need a filtered and paged list of items for analytics and reporting. Example: GET_ITEMS($filter="Item Cost gt 100", $top=50).
  - body: { top?: integer, skip?: integer, expand?: string, filter?: string, select?: string, orderby?: string }
- `POST https://api.mcp.ai/api/_21risk/get/items/per/month` — Tool to retrieve fact table data for ItemsPerMonth, one row per question per site per month. Use when querying monthly item data with OData parameters ($filter, $top, $skip, $select, maxPageSizeInMb).
  - body: { top?: integer, skip?: integer, filter?: string, select?: string, maxPageSizeInMb?: integer }
- `POST https://api.mcp.ai/api/_21risk/get/organizations` — Tool to retrieve organizations from the 21RISK OData API. Use when you need to list, filter, or paginate organizations via OData parameters after authentication is confirmed.
  - body: { top?: integer, skip?: integer, filter?: string, orderby?: string }
- `POST https://api.mcp.ai/api/_21risk/get/properties` — Tool to fetch a list of properties related to sites, including COPE information and other relevant data. Use when you need property insurance details via OData API after authentication.
  - body: { top?: integer, skip?: integer, filter?: string, select?: string, orderby?: string }
- `POST https://api.mcp.ai/api/_21risk/get/reports` — Tool to retrieve audit reports, including draft, published, and scheduled reports. Use when you need a paginated list of reports with optional OData filtering.
  - body: { top?: integer, filter?: string, skiptoken?: string, maxPageSizeInMb?: number }
- `POST https://api.mcp.ai/api/_21risk/get/risk/models` — Tool to retrieve risk models used for audits and compliance. Use when you need to list available risk models with optional OData queries.
  - body: { top?: integer, skip?: integer, count?: boolean, expand?: string, filter?: string, select?: string, orderby?: string, skiptoken?: string, maxPageSizeInMb?: number }
- `POST https://api.mcp.ai/api/_21risk/get/riskmodel/categories` — Tool to retrieve risk model categories for grouping questions and compliance checks. Use when you need to filter, select, or paginate risk model categories via OData parameters ($filter, $select, $ord
  - body: { top?: integer, skip?: integer, count?: boolean, expand?: string, filter?: string, select?: string, orderby?: string, skiptoken?: string, maxPageSizeInMb?: integer }

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

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