Agents & MCP for Limowo

Your agent. Your marketplace. Your call.

Connect Codex, Claude, ChatGPT, or another compatible agent to search Limowo, prepare a listing, and communicate with confidence. You stay in control of every real-world action.

Connect a client Open command terminal View commands

Human-controlled connection

V1 workflow

Browse marketplace

Search marketplace

Public agents can discover active listings and categories without credentials through typed read commands.

marketplace.articles.search

Prepare listing draft

Authorized agents can prepare draft data for the represented owner. Owner, author, and sender identities are derived from the grant.

listing.draft.create

Review with owner

Draft creation returns safe next actions so the human owner can review, edit, approve, and publish from Limowo.

listing.draft.validate

Route safely

Commands return route hints only for public listing/search pages or authenticated owner review pages.

nextActions[]

Live

/en/agents

Human-readable portal for safe web agent workflows.

Live

/llms.txt

Plain-text discovery summary for assistants and indexers.

Live

/.well-known/limowo-agent.json

Compact machine identity and rollout metadata.

Live

/mcp-server.json

Official remote-server metadata prepared for MCP Registry publication.

Live

/mcp

Provider-neutral Streamable HTTP endpoint for MCP clients.

Live

/api/agent/v1/openapi.json

Versioned contract generated from the active command registry.

Connect and use

Add to Codex

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

Add to Claude Code

claude mcp add --transport http limowo https://mcp.limowo.ch/mcp

Add to another MCP client

{
  "name": "limowo",
  "transport": "streamable-http",
  "url": "https://mcp.limowo.ch/mcp"
}

Discover commands

GET /api/agent/v1/commands

Prepare a public search

POST /api/agent/v1/commands/prepare
{
  "command": "marketplace.articles.search",
  "version": 1,
  "input": { "query": "bike", "take": 5 }
}

Execute unchanged input

POST /api/agent/v1/commands/prepared/{preparedCommandId}/execute

Route owner to review

nextActions: [
  {
    "id": "review_draft",
    "requiredActor": "HUMAN_OWNER",
    "risk": "DRAFT_WRITE"
  }
]

Authentication status

Public search and listing discovery work without authentication. Listing, conversation, and offer tools require a Keycloak OAuth token with Limowo's dedicated MCP audience and scope.

Safety boundaries

01
No arbitrary shell, SQL, GraphQL documents, filesystem operations, or unrestricted HTTP.
02
No autonomous article publication, offers, orders, payments, or account administration in V1.
03
Write commands require a Keycloak MCP token and idempotency; publication stays with the human owner.