Skip to content
Documentation menu

MCP

Expose the catalog to agents over the Model Context Protocol with a scoped key.

Endpoint

POST https://api.uselocal.sh/mcp implements MCP Streamable HTTP. Authenticate with a key that has the mcp scope (plus tools:execute to run tools).

Tools exposed

ToolDoes
catalog_searchSearch tools by text, category, source and availability.
tool_describeReturn a tool’s input schema, price basis and limits.
tool_quoteQuote a specific input before running it.
tool_executeRun a tool with a quote or ceiling; returns data and the receipt.
balanceRead the workspace balance.

Client configuration

json
{
  "mcpServers": {
    "local": {
      "url": "https://api.uselocal.sh/mcp",
      "headers": { "Authorization": "Bearer lcl_live_…" }
    }
  }
}

Give agents a budget

Create a dedicated key for agents with a monthly budget and a per-request ceiling. Agents cannot exceed what the key allows.