Public API + MCP
Let your AI assistant work in Semuko.With only the access you grant.
Semuko has an MCP server and a REST API on the same catalog. Connect Claude, ChatGPT, Gemini CLI or Cursor to look up leads, create invoices, or send a contract, limited to the scopes on the key.
API & MCP are included on Studio Pro and Agency Unlimited. Account admins create keys in Settings → Preferences → Developer. New keys start read-only.
Operations, each available as REST and as an MCP tool
Scopes, from read-only CRM to sending
Request limit per key
Your AI tools cannot see your studio
Copying client details into a chat window is slow, and handing over a full login is risky.
Pasting CRM data into chat by hand
Your assistant calls Semuko tools directly: list leads, get an event, create a project.
All-or-nothing access
Each key or OAuth grant carries scopes. The MCP server only lists tools those scopes allow.
Custom builds that break on undocumented endpoints
A versioned /api/v1 with an OpenAPI 3.1 document generated from the same catalog.
How it works
One catalog. REST for your code, MCP for your assistant.
- 1
Create a scoped key
An account admin creates a key and picks scopes. The secret is shown once and stored hashed.
- 2
Connect your assistant
Add the Semuko MCP URL to Claude, Cursor or Gemini CLI with the key, or connect ChatGPT through OAuth.
- 3
Approve the connection
OAuth clients go through a consent screen where an admin sees the requested scopes before approving.
- 4
Work from chat
Ask for this week’s unpaid invoices or a new lead. Sends are marked so your client asks before running them.
Try it with your own data
Start a free Studio Pro trial, create a read-only key, and connect your assistant. API & MCP are on Studio Pro and Agency Unlimited.
Built to be safe to hand to an AI
Guardrails come from the server, not from the prompt.
Scoped keys and OAuth
Bearer API keys for scripts and local clients. OAuth 2.1 with PKCE for remote MCP clients. Staff logins are never accepted.
Tools filtered by scope
A crm.read key only sees read tools. Sending email, invoices or contracts needs the comms.send scope.
Sends flagged for confirmation
Client-facing tools are marked destructive so MCP clients ask before running them. Hard deletes of CRM records are not exposed.
Audit log
Every REST and MCP call is logged with the key, operation, status and request ID.
Webhooks
Subscribe your endpoint to events like lead created or contract signed, through the API or in Settings.
Rate limited per key
120 requests per minute per key or OAuth token. Large MCP results are trimmed at 200 KB.
Tool catalog
What your assistant can do
All 40 operations are available as REST endpoints and as MCP tools named semuko_*.
Leads, clients, events, projects
- list leads
- get lead
- create lead
- update lead
- list clients
- get client
- create client
- update client
- list events
- get event
- create event
- update event
- list projects
- get project
- create project
- update project
Invoices and payments
- list invoices
- get invoice
- create invoice
- list payments
- send invoice
Contracts and questionnaires
- list contracts
- get contract
- create contract from template
- list questionnaires
- assign questionnaire
- send contract
Bookings
- list bookings
- get booking
- create booking
Actions and setup
- list brands
- list statuses
- list types
- list custom fields
- apply workflow
- convert lead
- send email
Webhooks
- list webhooks
- create webhook
- delete webhook
Full endpoint reference, scopes and client setup in the developer docs.
Works better together
More of Semuko that saves you time
One platform means fewer tabs, fewer tools, and one source of truth for your business.
FAQ
Questions before you try it
Straight answers for studios comparing tools or just getting started.
MCP (Model Context Protocol) lets AI assistants call tools. Semuko serves an MCP endpoint at /api/v1/mcp over Streamable HTTP. Each tool maps to a public API operation, and the list is filtered by the scopes on your key or OAuth grant.
Give your assistant a key, not your password
Start a free Studio Pro trial, create a scoped key, and connect the tools you already use.