Developer access
API & MCP Access
Create API keys, connect Verachi to your coding agent, and work with decisions programmatically.
UpdatedApr 30, 2026
On this page
Verachi supports API keys, REST-style app endpoints, and a stateless HTTP MCP endpoint.
API keys
- Open Settings.
- Go to Security & data.
- Open API keys.
- Create a key with the scopes your tool needs.
- Copy the key when it is shown.
Send API keys as bearer tokens:
Authorization: Bearer YOUR_API_KEY
Revoke keys you no longer use.
Scopes
Scopes are specific. Project or decision scopes do not automatically grant guideline or risk writes.
Examples:
guidelines:readguidelines:writerisks:readrisks:write
MCP endpoint
https://app.verachi.io/api/mcp
MCP requests are HTTP-based, stateless, and authenticated with the same bearer token header.
Example:
{
"mcpServers": {
"verachi": {
"url": "https://app.verachi.io/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Current MCP surface
MCP covers automation around:
- decisions
- projects
- documents
- guidelines
- risks
- connection identity through
auth_whoami
MCP does not expose chat execution, integration setup, audit administration, notifications, AI settings, organization/team/user management, or API-key management.
REST API
Common app endpoints include:
| Endpoint | Purpose |
|---|---|
/api/decisions | List or create decisions |
/api/projects | List or create projects |
/api/risks | List or create risks |
/api/project-guideline-sets | Create guideline sets |
/api/projects/:id/guidelines | Manage project guidelines |
/api/documents | List documents |
/api/documents/upload | Upload document files |
/api/chat | Run grounded chat |
/api/chat/sessions | List or create chats |
/api/integrations/* | List and update connected providers |
/api/notifications | List notifications |
/api/audit-trail | Read audit timeline |
/api/me/api-keys | Manage personal API keys |
/api/mcp | MCP endpoint |
Use the web app for workspace administration unless you are building against a documented API flow.