rubenayla/partle-mcp

Model Context Protocol server for the Partle marketplace — let your AI shop here: search products and stores, get prices and purchase links, or ask it to add a listing for you, all without leaving your assistant.
Live product and store coverage is available through the get_stats tool. Public catalogue reads need no auth. Writes and private inventory reads need OAuth or a pk_… API key.
Two ways to run it
Remote (recommended — zero setup)
Point your MCP client at:
That's it. Streamable HTTP transport, MCP spec 2025-06-18. Per-client install instructions: /documentation/mcp-setup/.
Local stdio (for clients that prefer installable servers, or for Glama / Smithery scoring)
Or with uvx (no install):
Or with Docker:
The stdio package proxies to the public REST API at https://partle.rubenayla.xyz, so you don't need a database or local backend.
Claude Desktop / Claude Code (stdio)
Tools (20 total)
Read (no auth)
| Tool | Purpose |
|------|---------|
| search_products | Search the catalog by name, price range, tags, store. Supports cross-language semantic search. |
| get_product | Full record for one product by ID. |
| search_stores | Search/list stores by name or address. |
| get_store | Full record for one store by ID. |
| get_stats | Platform-wide totals. |
| search_wanted | Browse public **buy requests** at /wanted — things people are looking to buy but haven't found. Cross-reference against search_products to offer matches. |
Write (authenticated)
Two ways to authenticate, in preference order:
1. **OAuth (recommended)** — when you add Partle as a custom connector in claude.ai or any MCP client that supports OAuth, the client walks you through a one-click consent screen and attaches a bearer token automatically. Scopes: products:read, products:write, inventory:read, inventory:write. Revoke at /account → **Connected apps**. RFC 9728 metadata at /.well-known/oauth-protected-resource; RFC 7591 dynamic client registration at /oauth/register.
2. **API key (fallback)** — pass an api_key parameter to any write tool. Generate at /account → **API Keys**. Use this when your client doesn't support OAuth (raw scripts, programmatic agents).
**Products** — public catalog listings.
| Tool | Purpose |
|------|---------|
| create_product | Add a new listing. Set verified=false when an AI is proposing on behalf of an unconfirmed human. |
| update_product | Edit a listing you own. |
| delete_product | Remove a listing you own. |
| upload_product_image | Attach an image (base64 or URL). |
| delete_product_image | Remove an image from a product. |
| get_my_products | List products you've created. |
> The remote HTTP server also offers get_upload_url (re-fetches a signed upload URL for an existing product). Not exposed in this stdio package — use the remote server if you need it.
**Inventory** — private workshop tracking (owned / wanted / for_sale / sold / discarded). Private to the owner; **does not** appear on the public /wanted feed.