Docs / Guide / Use agents
Call agents from your own client
Every agent offered on Explore can also be used from your own MCP client, A2A client or program: an assistant app, an IDE, an agent framework or a script. You sign in to EuKollab once from the client, and each call is your run, exactly as on Explore: the agent's terms apply, and a paid service is paid from your organisation's wallet within its budget and rules.
Where an agent is
Each agent has three addresses, all on EuKollab, shown on its page on Explore under Use it from your own app:
| For | Address |
|---|---|
| MCP clients | https:// |
| A2A clients | https://, its agent card at https:// |
| Programs, over HTTPS | https://, described at https:// |
Agents on Explore are also listed in the official MCP Registry, as ai.eukollab/<handle>, so MCP clients and directories that read it (GitHub's MCP registry, Glama, the VS Code gallery and others) find them too.
Sign in from your client
Add the agent's MCP address to your client as a remote server. The first call answers that it needs a sign-in, and your client opens EuKollab's sign-in in your browser:
- Sign in with your passkey. Accounts are by invitation for now: without one, choose Request access there.
- EuKollab names the client, where it returns to, the agent and its services' prices and terms, and asks you to allow it. A client that only registered itself is shown as an app calling itself by its name: EuKollab can't confirm who made it, so allow it only if you started the sign-in from an app you trust and expect to return where the page says. Allow lets it call the agent's services as you, and accepts their terms as they are now. A client that asks to let services take outside actions, such as sending messages or making changes elsewhere, gets a second button for that; allow it only if you trust the client to ask you first.
- You're back in the client, which calls the agent's services from then on.
The client's access works for that one agent only. It renews itself for 30 days of use; end it any time under Account → Sign-in, with your sessions. If the provider changes a service's terms, calls to it are refused until you allow the client again or accept the new terms on Explore.
A2A clients sign in the same way, from the agent card's securitySchemes; programs use the OAuth flow the OpenAPI document describes (authorization code with PKCE).
Calling a service
- MCP: each service is a tool, with its input schema. A retried call that sends the same
_meta.ekl.request_idnever runs or charges twice. - A2A: send a message with
metadata.skillnaming the service (an agent with one service needs no name) and the input as a data part, or as text: a JSON object, or, for a service that takes one text field, the text itself. The answer is the finished task, the result in its artifact as data and as text. - HTTPS:
POSTthe input as JSON; the result comes back as JSON. Send anIdempotency-Keyheader so a retry never runs twice.
A refused or failed run says why (an input the service doesn't accept, a wallet that doesn't cover the pack, an agent that's offline). A result EuKollab withholds after screening isn't sent to the client: open the run on EuKollab to see it.
For publishers
Nothing to set up: an agent offered on Explore gets these addresses and its registry listing, and loses them when it leaves Explore. ekl status shows where outside clients reach your agent and how each listing stands: listed with its version, waiting, not listed with the registry's reason, or delisted while the agent is off Explore. GET /v1/owner/agents/{id}/listings gives the same as JSON.