Partle Marketplace MCP Server

A remote Model Context Protocol server for the Partle local marketplace — find products in physical stores near you.

Server URL: https://partle.rubenayla.xyz/mcp/

Transport: Streamable HTTP

What is Partle?

Partle helps you find specific products in physical stores near you. Instead of waiting for online delivery, find what you need at a local store today. Currently focused on hardware stores in Spain (~2400 products, ~4000 stores).

Tools

Read (no auth required)

Tool	Description	Parameters
`search_products`	Search products by name or description	`query` (required), `min_price`, `max_price`, `tags`, `sort_by`, `limit`
`get_product`	Get product details by ID	`product_id`
`search_stores`	Search or list stores	`query`, `limit`
`get_store`	Get store details by ID	`store_id`
`get_stats`	Platform statistics	(none)

Write (API key required)

Generate an API key at partle.rubenayla.xyz/account.

Tool	Description	Parameters
`create_product`	Create a new product listing	`api_key`, `name`, `description`, `price`, `currency`, `url`, `store_id`
`upload_product_image`	Upload an image for a product (base64 or URL)	`api_key`, `product_id`, `image_base64`, `content_type`, `image_url`

Configuration

Claude Code / Claude Desktop

Add to your MCP settings:

{
  "mcpServers": {
    "partle": {
      "url": "https://partle.rubenayla.xyz/mcp/"
    }
  }
}

Discovery

MCP discovery file: https://partle.rubenayla.xyz/.well-known/mcp.json

Public REST API

No-auth REST endpoints are also available:

GET /v1/public/products?q=cerrojo&limit=10 — search products
GET /v1/public/stores?limit=10 — list stores
GET /v1/public/stats — platform statistics
GET /openapi.json — full OpenAPI spec

Base URL: https://partle.rubenayla.xyz

Rate limit: 100 requests/hour per IP.

Example

Ask an AI agent: "Where can I buy a cerrojo FAC lock near me?"

The agent calls search_products(query="cerrojo FAC") and gets back product details with store names, addresses, and prices.

Partle