Public API & MCP

Your data,
for every integration

Connect YOWO7 to your tools and AI agents via HTTP API or MCP. One Private App, one token, fine-grained scopes — the same surface for both.

Public API

HTTP API on api.yowo7.com with a Bearer token (y7_…). The same workspace endpoints as the app, each with the matching scope.

MCP for AI agents

A JSON-RPC endpoint /mcp (protocol 2024-11-05) with 131 tools — usable straight from Cursor and other agents.

Private Apps

Create in Admin: token, scopes, optional mailbox access, logs and a per-app rate limit.

Fine-grained scopes

CRM, Inbox, Projects, Files, Forms and Workspace — read and write, exactly as much as needed.

OpenAPI & Swagger

The Public API spec is available as Swagger under /swagger — in production too.

One surface for both

MCP and the HTTP API mirror the exact same endpoints. A Private App reaches no more via MCP than via HTTP.

CRM, Inbox, Projects, Files

Read and write records, threads, tasks, time, checklists and drive files — plus company profile, brand and style sets.

Secure by token

Auth via Private App token instead of a user login — scopes and mailbox access are controlled in Admin.

Try it quickly

OpenAPI spec and MCP tools/list — no secrets, placeholder token only.

curl -s https://api.yowo7.com/swagger/public/swagger.json
curl -s -H "Authorization: Bearer y7_…" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' https://api.yowo7.com/mcp

FAQs about API & MCP

None functionally. The Public API is HTTP with a Bearer token, MCP is JSON-RPC for AI agents. Both use the same Private App, scopes and endpoints.

With a Private App token (y7_…) as Bearer. The token, its scopes and mailbox access are granted under Admin → Private Apps.

CRM, Inbox, Projects, Files/Storage, Forms (read) and Workspace — read and write depending on the granted scopes.

131 tools. An agent only sees the tools for the scopes the Private App was granted.

Yes. With scope workspace:read: workspace_list_style_sets and workspace_get_style_set. The password vault is not available via API or MCP.

Ready to integrate?

Create a Private App, pick scopes and connect your tools or AI agents to YOWO7.

Get started

Public API and MCP on api.yowo7.com · OpenAPI under /swagger