One-step connection
Let your agent do the price checking.
Deverra is built to be connected to an assistant rather than browsed. You say "check what this costs" and the agent queries the API, reads every merchant offer, and answers with a live price and a link. You approve the connection once. After that there are no commands to type and nothing to install by hand.
"Set up Deverra so you can check live prices for me."
It will read agent.md, register a free key, and tell you exactly what it can see before it does anything.
What the agent can access, and what it cannot
Because a connection request should never be vague, here is the complete list.
| Permission | What it allows | Why it is needed |
|---|---|---|
| Product lookup | Search the public catalog and read merchant offers. | This is the entire product. No other capability exists. |
| Price retrieval | Read current price and stock for a specific product. | Prices move; a cached number would be wrong. |
| Key storage | Store one API key in the agent's own secret store. | Attributes usage and enforces the free rate limit. |
It does not get your email inbox, your files, your browser, your payment details, or any account on any retailer. It reads a public product catalog and nothing else. There is no payment surface at all: no card is ever accepted or stored here.
Connect it
Pick the host you use. Each one is a single file or field.
MCP — any host that supports it (recommended)
{
"mcpServers": {
"deverra": {
"type": "http",
"url": "https://deverra.devilabs.dev/mcp"
}
}
}
Claude Code
claude mcp add --transport http deverra https://deverra.devilabs.dev/mcp
Direct HTTP — any agent runtime
# 1. Register once. Free, no card.
curl -sX POST https://deverra.devilabs.dev/api/v1/keys \
-H 'content-type: application/json' \
-d '{"email":"you@example.com"}'
# 2. Store the returned key as AN_API_KEY, then query:
curl -sX POST https://deverra.devilabs.dev/api/v1/search \
-H "x-api-key: $AN_API_KEY" \
-H 'content-type: application/json' \
-d '{"query":"noise cancelling headphones","limit":5}'
After it is connected
Nothing else is required. A typical exchange:
You: what does the Sony WH-1000XM5 cost right now?
Agent: Cheapest is $298.00 at two retailers, with a $52 spread across
four merchants. This link earns the site a commission.
That last clause is the agent doing the honest thing. It does not change the price it quotes or the merchant it picks; it just says how the site is paid. We ask agents to state it, and we ask you to expect it.