Developers
Connect WŬMÙ to your systems
WŬMÙ is open to integrations in three ways: apps sign in with OAuth 2.0 and PKCE and work with data through REST API v2 with an OpenAPI description, while AI assistants connect to the MCP server by URL.
Keys are issued in the developer console: sign in to WŬMÙ, create an app and get your client_id.
https://wumu.ru
- Authorization
- /api/oauth/authorize
- Tokens
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- MCP server
- /mcp
Three ways to connect
Choose how to connect
Your own app or service connects through OAuth and the REST API. An AI assistant connects through the MCP server, with no app to register.
OAuth 2.0 with PKCE
For websites, services and mobile apps that work with a WŬMÙ user's data with their consent.
- Authorization code with PKCE (S256) and refresh token rotation; client_credentials for server-to-server calls
- The user sees a consent screen and grants only the scopes you need: profile, documents, chats, contacts and more
- Public clients — mobile apps and SPAs — get no secret
- Webhooks signed with HMAC-SHA256, plus a log of requests and deliveries in the developer console
- A new app goes live after a WŬMÙ administrator reviews it
REST API v2
A JSON API to documents, spreadsheets, AI chats, the messenger, contacts, the calendar and other parts of WŬMÙ.
- A machine-readable OpenAPI description that names the scopes each operation needs
- The access token goes in the Authorization: Bearer header
- A per-minute request limit for each app and user pair; going over it returns 429
MCP server
An AI assistant connects to a WŬMÙ account by URL — no keys, no developer app and nothing to install.
- Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Cursor and other clients that support remote MCP servers with OAuth sign-in
- You sign in with your own account and choose the sections yourself; reading and changing data are separate switches
- Sections with other people's data — requests, the messenger, contacts — are off by default
- You can disconnect the assistant at any time in your account's security settings
Connection URL
https://wumu.ai/mcpFor an account on wumu.aihttps://wumu.ru/mcpFor an account on wumu.ru (Russia)
Example request
Your first request
Get an access token through OAuth and pass it in the header: the first request returns your five latest chats with the AI lawyer and needs the read:chats scope. The second command adds the WŬMÙ MCP server to Claude Code.
# your five latest chats with the AI lawyer
curl "https://wumu.ru/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# add the WŬMÙ MCP server to Claude Code
claude mcp add --transport http wumu https://wumu.ru/mcpDeveloper questions
Do I need a paid plan to use the WŬMÙ API?
OAuth apps and REST API v2 need no paid plan: you can create an app on any WŬMÙ plan, the free one included. An AI assistant can connect to the WŬMÙ MCP server on the free plan too, with access to your profile, city drafts and help center; the other sections require your own Pro plan or higher, and a Business trial counts too.
How do I get a WŬMÙ API key?
Sign in to WŬMÙ and open the developer console. Create an app with a name, redirect URLs and scopes. You get a client_id, and a server-side app also gets a client_secret — it is shown only once, so store it safely. The app starts issuing tokens after a WŬMÙ administrator reviews it.
Where is the WŬMÙ REST API description?
The OpenAPI description of REST API v2 is open without sign-in at /api/v2/openapi.json: load it into any tool that understands OpenAPI or generate a client from it. The WŬMÙ authorization server metadata is at /.well-known/openid-configuration.
Open the OpenAPI descriptionDoes the WŬMÙ API limit the number of requests?
Yes. REST API v2 limits each app and user pair: 100 requests per minute by default, and some sections, such as the messenger, have their own limit. Going over it returns status 429 — retry the request later. An AI assistant connected over MCP has a per-minute request limit too.
How is the WŬMÙ MCP server different from an OAuth app?
The WŬMÙ MCP server is a ready-made connection for AI assistants: there is nothing to register — paste the URL and sign in with your account. An OAuth app is what you need when you build your own integration: a website, service or mobile app that calls REST API v2 on behalf of users.