Tanilo

io.github.TKCollectivev3.0.0Updated Oct 9, 2026

Tanilo checks the premise before an AI agent acts.

VerifiedSTDIODesktop onlyBusiness & CommerceFinance

Overview

AI-generated overview

Lets an assistant check whether an offer's unit price matches caller-supplied contract terms, returning a verdict and a signed receipt.

What it does
Tanilo exposes one check, the contract price check, plus two status documents. Given an offer (unit price, currency, unit, and optional quantity, seller, SKU, offered_at) and a list of terms, it compares the offer price with the applicable term and returns verified, contradicted, or indeterminate with a reason, along with a signed receipt. The comparison is deterministic arithmetic, not a model call, and the caller supplies the terms. Two further tools return the API health document and the discovery manifest.
When to use it
Use it when an agent is about to accept a quoted price and you want a deterministic, recomputable check against terms you already hold, with a signed receipt for the result. It is not a contract lookup service and does not decide whether to pay.
Requirements
Runs locally over stdio, installed via npx tanilo-mcp, and needs network access to the Tanilo API. The routes are in free beta, rate-limited, and need no key. No environment variables or credentials are declared; TANILO_PYTHON and TANILO_API_BASE are development and test settings only.
Before you install
The server sends your offer and terms to a third-party API. A valid signature shows which key signed the bytes and that they are unchanged, not that the supplied terms are genuine. The server does not verify signatures itself; use the separate offline verifier. It holds no secrets, makes no payments, and has no wallet.

Installation

In SourceWeft

  1. Open Tanilo in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Tanilo MCP server

An MCP server that connects Claude Desktop, Cursor, Windsurf or any other MCP client to the Tanilo API at https://api.tanilo.io.

Tanilo checks the premise before an AI agent acts. This server exposes one check, the contract price check, and two status documents. The routes it calls are live in free beta, rate-limited, no key needed. The server holds no secrets and makes no payments.

Tanilo was AgentOracle until September 2026. Versions up to 2.1.2 were published as agentoracle-mcp; that package is no longer maintained.

This README describes version 3.0.0. The outputs below were captured on 2026-10-08 by running the tools against the live API.

Install

bash
npx tanilo-mcp

Claude Desktop

Open your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this and restart Claude Desktop:

json
{  "mcpServers": {    "tanilo": {      "command": "npx",      "args": ["-y", "tanilo-mcp"]    }  }}

Cursor (Settings → MCP → Add Server) and Windsurf (Settings → MCP Servers → Add) take the same tanilo block.

Tools

check-contract-price

Does this offer match the terms you supplied? Before an agent accepts an offer, contract_price_match compares the offer's unit price with the applicable term among the terms you supply, and signs the result when signing succeeds.

No model is involved: the result is arithmetic and exact comparison, and anyone holding the same input can recompute it. You supply the terms; Tanilo does not hold or look up your contracts. Three results: verified, contradicted, or indeterminate with a reason. A verified result says the price matches the supplied term. Whether to pay is your policy's decision.

Input: offer (unit_price, currency, unit, and optionally quantity, seller, sku, offered_at) and terms (a list; each has agreement_id, version, currency, unit, and either price_per_unit or tiers, plus optional seller, product_scope, effective_from, effective_to, supersedes). Prices and quantities are decimal strings such as "2.00". The full input rules, tiers and amendments are at https://tanilo.io/docs/contract-price-check.

The tool returns the check result and the signed receipt. Captured live on 2026-10-08 for the docs example (an offer of USD 2.00 per call against a supplied term of USD 1.00 per call), trimmed:

json
{  "verdict": "halt",  "state": "contradicted",  "outcome": "fail",  "reason": "price_mismatch",  "recommendation": "offer price differs from the applicable term among the supplied terms",  "evidence": {    "rule_id": "contract-price-match/v0.1",    "terms_source": "caller_supplied",    "expected": { "price_per_unit": "1.00", "currency": "USD", "unit": "call" },    "offered": { "unit_price": "2.00", "currency": "USD", "unit": "call", "quantity": "1" },    "difference_per_unit": "1.00",    "offer_is": "above_term_price"  },  "check_mode": "deterministic",  "canonical_sha256": "sha256-…",  "kid": "tanilo-2026-10-ed25519-7d885da9",  "jwks_url": "https://tanilo.io/.well-known/jwks.json",  "receipt": { "payload": "…", "signatures": [ … ] }}

With "terms": [] the same offer gives state indeterminate, reason no_applicable_term, verdict halt.

A valid signature shows which key signed these bytes and that they have not changed since. It does not show that the supplied terms were genuine. Check the signature offline with tanilo-receipt-verify against the key set at https://tanilo.io/.well-known/jwks.json:

bash
pip install tanilo-receipt-verifypython3 -c "import json; from tanilo_receipt_verify import verify; r = verify(json.load(open('receipt.json')), jwks_by_issuer={'https://tanilo.io/.well-known/jwks.json': json.load(open('jwks.json'))}); print(r.status, r.canonical_sha256)"

where receipt.json holds the tool's receipt object and jwks.json the key set.

check-health

Returns the API's status document (GET /health): service status, the live routes and their prices, the retired routes, and rate limits.

get-manifest

Returns the API's discovery document (GET /.well-known/x402-manifest.json). It lists no payable resources: the paid research routes were retired on 2026-10-04.

What this server does not do

  • It has no tool for Tanilo's claim check (POST /evaluate) yet. The route is free during the beta and can be called directly; see https://tanilo.io/pricing.
  • It does not pay for anything, hold a wallet, or read any key. The x402 payment code of earlier versions is gone.
  • It does not verify signatures itself; use tanilo-receipt-verify as above.

Development

bash
npm installnpm run buildnpm test          # starts the built server over stdio and calls the live API (free beta route)

Set TANILO_PYTHON to a Python that has tanilo-receipt-verify installed and the test also verifies the returned receipt's signature offline. Set TANILO_API_BASE to point the server at another host (tests only).

Links

Contact: [email protected]

MIT licensed. TK Collective LLC.

Source: README.md at commit 25fbca9

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v3.0.0LatestOct 9, 2026