The Uely interface
This content is not available in your language yet.
This behaviour is changing. As of: 2026-09-03. Current commercial details: uely.ch/preise.
Uely-3000 has a public interface for programs. It is the same product a farmer uses in the app — the same workspace, the same billing, the same knowledge base — reached by an agent acting on their behalf.
This section is in English. The rest of the handbook is written for farmers and is German first; this part is written for whoever is integrating.
One endpoint, one allowlist
Abschnitt betitelt „One endpoint, one allowlist“https://api.uely.ch/mcp— an MCP server over streamable HTTP. 27 tools.- A small REST allowlist — 17 route-and-method pairs for callers that would rather speak HTTP than MCP. Every one of them is reachable with the same token.
Nothing else is public. The app’s own endpoints exist, but they take a browser session and are not part of this contract.
Two credential planes
Abschnitt betitelt „Two credential planes“This is the distinction to get right before anything else, because tokens from one plane are refused on the other.
| Plane | Audience (aud) | What it is for |
|---|---|---|
| Identity | https://api.uely.ch/oauth/userinfo | Signing a person in. “Who is this?” |
| Agent | https://api.uely.ch/mcp | Acting inside a workspace |
They use disjoint scope vocabularies. Identity has openid and profile; the agent plane
has the nine product scopes listed in Authorize. A request
mixing the two is invalid_scope, not silently downgraded.
Ask for the agent plane with the RFC 8707 resource parameter:
resource=https://api.uely.ch/mcpWhat costs money
Abschnitt betitelt „What costs money“Reaching the workspace through an agent requires the account to be on a paid plan —
lehrling, buezer, meister or enterprise. payg is deliberately not one of them: a
person can use the app on pay-as-you-go, but letting a program in is a subscription feature.
ask is metered and charged per call, in the same AKh currency the app uses. The read tools
are not metered.
If the person you are acting for has no account at all, you do not need to send them away — see Signup.
Versioning
Abschnitt betitelt „Versioning“Paths are unversioned and stay unversioned. There is no /v2, and there will not be one
without an announcement here.
The version of record is info.version in the OpenAPI document at
https://api.uely.ch/openapi.json.
What will change
Abschnitt betitelt „What will change“The banner at the top of these pages is not decoration. This interface is young: it reached production in September 2026, and parts of it are still settling. Where behaviour is likely to move, the page says so in place rather than leaving you to find out.
Where a page and the running service disagree, the service is right — and it is worth telling us, because it means this page is wrong.