Limowo MCP connection guide
Connect your client.
Connect ChatGPT, Codex, Claude, or another compatible MCP client through Keycloak OAuth—without copying a Limowo token or shared secret by hand.
Agents & MCP
Your agent, connected to Limowo MCP.
Not in the mood to create the listing yourself? Your agent can do it with Limowo MCP.
How Limowo MCP works
Three clear steps.
The same flow shown in the workspace: connect your client, ask in plain language, and approve the actions that matter.
- 01
Connect
Add the official endpoint, then sign in through Limowo OAuth with your own account.
- 02
Ask
Use natural language to search listings or prepare a clear draft from the details you provide.
- 03
Approve
Review any meaningful outcome. Publishing, messages, and offers remain your decision.
ChatGPT setup
Connect ChatGPT in five steps.
ChatGPT discovers Limowo's OAuth configuration automatically. You only provide the official MCP URL, scope, and resource—never a Limowo token or a client secret.
01
Open the plugin setup in ChatGPT
Open ChatGPT's Plugins page and choose New Plugin. In some workspaces this page appears under Settings and Apps; you are looking for the form that asks for an MCP server URL.
02
Add the Limowo MCP endpoint
Paste the hosted Streamable HTTP endpoint exactly as shown. It is the single official endpoint for ChatGPT and other compatible clients.
https://mcp.limowo.ch/mcp
03
Let ChatGPT configure OAuth
After ChatGPT validates the URL, open Advanced OAuth settings and choose Dynamic Client Registration (DCR). Set the default scope to limowo-mcp and the resource to the same Limowo MCP URL. ChatGPT discovers the authorization details and creates its own restricted client—never paste a shared client secret into ChatGPT.
Scope: limowo-mcp Resource: https://mcp.limowo.ch/mcp
04
Sign in with Limowo
Save the app, choose Sign in with Limowo, and complete the Keycloak sign-in and consent screens. When finished, ChatGPT returns to the app with your Limowo connection.
05
Try a safe first request
Ask ChatGPT to search Limowo for an item or category. Public marketplace discovery works without sign-in; protected listing, conversation, and offer tools appear only when Limowo has enabled them and still keep the final action with you.
Other compatible MCP clients
The same endpoint and OAuth discovery flow work for compatible clients. Their screens differ, but the Limowo values do not.
01
Add Limowo
Use the hosted MCP endpoint. Public marketplace search works without signing in.
codex mcp add limowo --url https://mcp.limowo.ch/mcp
02
Use OAuth discovery
Choose OAuth and let your client discover Limowo's protected-resource metadata. Compatible clients use Dynamic Client Registration (DCR); do not copy a shared client ID or client secret from another integration.
Scope: limowo-mcp Resource: https://mcp.limowo.ch/mcp
03
Sign in
Start the OAuth login. Keycloak authenticates you, asks for consent, and returns the short-lived Limowo MCP token to your client.
codex mcp login limowo
04
Use human-controlled tools
Search is public. After login, listing drafts, conversations, and offers appear only when Limowo has enabled their server-side release flags. Publishing, message delivery, and offer changes still require the relevant human approval.
Connection requirements
Limowo validates the Keycloak issuer, the dedicated MCP audience, the limowo-mcp scope, a verified email, and the token signature. Compatible-client metadata is available at /.well-known/oauth-protected-resource/mcp.