Limowo MCP connection guide

Connect your client.

Codex, Claude, and compatible MCP clients connect through Keycloak OAuth—without copying a Limowo token by hand.

Add Limowo

Use the hosted MCP endpoint. Public marketplace search works without signing in.

codex mcp add limowo --url https://mcp.limowo.ch/mcp

Configure the registered OAuth client

Your MCP client must use the Keycloak client ID registered for it. The ID and callback are issued by the Limowo identity operator; do not guess either value.

[mcp_servers.limowo.oauth]
client_id = "<registered-limowo-keycloak-client-id>"

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

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. The metadata needed by compatible clients is available at /.well-known/oauth-protected-resource/mcp.

Agent documentation Open command terminal

The agent marketplace, with you in charge

Bring your agent to the marketplace.

Search Limowo naturally, prepare a listing, or communicate with an article owner. Your agent helps; you decide what becomes real.

Connect

Bring your agent.

Connect Codex, Claude, ChatGPT, or another compatible MCP client to your Limowo account through Keycloak.

You authenticate. Limowo verifies the connection.

→

Find the right article.

Ask naturally for listings by item, category, location, price, or distance. Public marketplace discovery works without signing in.

Your agent returns current Limowo results, not guesses.

→

Sell

Prepare a great listing.

Turn a conversation into a clear article draft with the details you provide, ready for your review in Limowo.

Nothing is published until you approve it.

→

Buy

Communicate with confidence.

Read your conversations, prepare a message, and make or respond to an offer without losing control of the final action.

Messages and offer changes stay human-approved.