Palate
Developers

Build against the quote-first contract.

Palate gives agents a small set of HTTP routes and a per-Palate MCP surface. Discover relevant Palates, request a quote, pay on the rail you support, then return cited chunks or a grounded answer.

Agent hot path
GET /api/palatesGET /api/palates/<slug>/channelsPOST /api/palates/<slug>/quotePOST /api/palates/<slug>/queryGET /<slug>/mcpPOST /<slug>/mcp

HTTP and MCP

HTTP is canonical. MCP exposes the same channel, quote, and query flow through tools/list and tools/call for agent clients that prefer tools.

{
  "mcpServers": {
    "palate-expert": {
      "url": "https://palate.inc/{palate-slug}/mcp"
    }
  }
}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "palate_quote",
    "arguments": {
      "query": "What does Patrick look for in an exceptional business?",
      "mode": "synthesized"
    }
  }
}

Tempo

Agents can pay USDC on MPP Tempo, with pathUSD reserved as a fallback or Tempo Moderato test token. Palate sponsors fees in v1 so the quoted content price is the amount the agent plans around.

"paymentProof": {
  "rail": "tempo",
  "walletAddress": "0x...",
  "quoteNonce": "quote-nonce-from-quote-response",
  "txHash": "0x..."
}

x402 over Base

Agents can pay USDC through the x402 flow on Base. Payment proof is sent to the same query endpoint as Tempo.

"paymentProof": {
  "rail": "x402_base",
  "walletAddress": "0x...",
  "quoteNonce": "quote-nonce-from-quote-response",
  "facilitatorReceipt": "receipt_..."
}
Sandbox flow

Test the full quote, pay, query loop.

Download OpenAPI
Ready
Quote and query responses appear here.

1. Discover Palates

Use discovery only to find a short relevant set. Do not dump the directory into a user response.

curl "https://palate.inc/api/palates?limit=10"

2. Request a free quote

A quote returns line items, supported rails, a nonce, expiry, and the exact total before payment.

curl -X POST https://palate.inc/api/palates/{palate-slug}/quote \
  -H "content-type: application/json" \
  -d '{"query":"What should I understand from this expert profile?","mode":"raw"}'

3. Query with proof

Send the same user-visible question and channel scope after paying on a supported rail.

curl -X POST https://palate.inc/api/palates/{palate-slug}/query \
  -H "content-type: application/json" \
  -d '{
    "query":"What should I understand from this expert profile?",
    "mode":"synthesized",
    "paymentProof":{
      "rail":"x402_base",
      "walletAddress":"0x...",
      "quoteNonce":"quote-nonce-from-quote-response",
      "facilitatorReceipt":"receipt_..."
    }
  }'