kcaldata
nutrition api · agent-native

Calorie data,
built for
machines to call.

Send messy food text the way a person actually types it. Get back clean, sourced calorie JSON — no scraping, no guesswork.

50 free calls/day, no key required · pay-per-call for agents over x402

GET /v1/lookup?query=2 large eggs
kcaldata response
Egg, whole, raw, fresh
Calories 143 kcal
per 100 g143 kcal
how we got it2 × (1 large ≈ 50 g) = 100 g
confidence0.99
sourceUSDA SR Legacy
real fields from the live endpoint — pick a query to see it change
01

What makes it worth calling

matching

It reads food like a human wrote it

"2 large eggs", "a cup of cooked rice", "grilled chicken breast" — kcaldata parses the quantity and unit, finds the right whole food over the processed lookalike, and does the math. The hard part isn't the data; it's understanding the request.

agent-native

Made to be a tool, not a website

Call it as plain REST, connect it as an MCP tool in Claude, ChatGPT, or Gemini, or let an autonomous agent pay per call over x402. One service, every way an agent might reach for it.

honest by default

Every answer shows its work

Responses carry the matched food, the per-100g value, the exact grams used, and a plain-language basis line. Built on USDA FoodData Central (public domain) — so you can always see, and trust, where a number came from.

02

Agents pay per call, in USDC

No accounts, no invoices, no card forms. An AI agent hits the paid endpoint, the endpoint quotes a price, the agent pays a fraction of a cent in USDC, and the data comes back — all in one HTTP round-trip, no human in the loop.

This is the x402 standard (HTTP 402, revived) — the same rail Coinbase, Cloudflare, Visa, and others are building agent payments on.

01Agent calls the paid endpoint
02402 returns the price + wallet
03Agent signs a USDC payment
04Data returns with a settlement receipt
03

Start in one request

Free REST call no key

Try it from your terminal right now. 50 calls a day, free.

# messy text in, sourced calories out
curl -G "https://api.kcaldata.com/v1/lookup" \
  --data-urlencode "query=2 large eggs"

Connect as an MCP tool agents

Add kcaldata to Claude (or any MCP client) as a custom connector.

# Streamable HTTP MCP endpoint
https://api.kcaldata.com/mcp-server/mcp

Pay-per-call endpoint x402

For autonomous agents paying in USDC on Base.

GET /v1/pro/lookup?query=...
# returns 402 with price + wallet,
# then the data once paid

Machine-readable spec openapi

Full schema for codegen, tooling, and agents.

https://api.kcaldata.com/openapi.json
# interactive: /docs
04

Pricing

free

50 calls / day

No key, no signup, no card. Call the REST endpoint or connect the MCP tool and start immediately. Enough to build and test a real integration.

$0 · forever

developers

Monthly API key

For apps that need more than the free tier. A dedicated key with a raised daily limit, billed monthly in USDC. Email for a key — issued manually while we're small, so you'll talk to a human.

25 USDC / month · kcaldata@protonmail.com

agents

Pay per call

For autonomous agents with a wallet. No account, no subscription — the endpoint quotes a price, your agent pays in USDC over x402, and the data comes back in the same round-trip.

$0.005 / call · USDC on Base