{"openapi":"3.1.0","info":{"title":"protocol-tvl-brief","version":"0.1.0","description":"Compact DeFi protocol brief by slug or name: current TVL, 1d/7d/30d TVL change, TVL by chain, category, chains, audit links, fees and revenue for 24h/7d/30d where available, DefiLlama URL. Data by DefiLlama. Not financial advice.; Resolves a protocol name or partial name to candidate DefiLlama slugs, ranked by match quality then TVL. Returns slug, name, category, chains and TVL for each. Data by DefiLlama. Not financial advice.","x-guidance":"Protocol TVL Brief returns a compact DeFi protocol brief from DefiLlama. `protocol_brief` takes a protocol slug or name and returns current TVL, 1d/7d/30d TVL change, TVL by chain, category, chains, audit links, fees and revenue for 24h/7d/30d where available, and the DefiLlama URL. `find_protocol` resolves a name to candidate slugs. Summaries only, never raw history. Data by DefiLlama (defillama.com). Not financial advice. Tools: `protocol_brief`, `find_protocol`.","contact":{"email":"jeff@fosterinstruments.com"}},"servers":[{"url":"https://protocol-tvl-brief.x402supply.com"}],"paths":{"/mcp":{"post":{"operationId":"protocol-tvl-brief_call","summary":"Call protocol-tvl-brief via MCP tools/call","tags":["protocol-tvl-brief"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"protocol_brief"},"arguments":{"type":"object","properties":{"protocol":{"type":"string","minLength":1,"maxLength":80,"description":"DefiLlama protocol slug (e.g. aave, uniswap-v3) or exact protocol name"}},"required":["protocol"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}},{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"const":"tools/call"},"params":{"type":"object","required":["name","arguments"],"properties":{"name":{"const":"find_protocol"},"arguments":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":80,"description":"Protocol name or partial name, e.g. aave or uniswap"},"limit":{"type":"integer","minimum":1,"maximum":20,"description":"Maximum candidates to return, 1-20","default":5}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}}}}]}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["slug","name","kind","chains","tvl","tvlByChain","auditLinks","fees","defillamaUrl","attribution","source"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"category":{"type":["string","null"]},"website":{"type":["string","null"]},"chains":{"type":"array","items":{"type":"string"}},"tvl":{"type":"object","required":["currentUsd","change1dPct","change7dPct","change30dPct","asOf"],"properties":{"currentUsd":{"type":["number","null"]},"change1dPct":{"type":["number","null"]},"change7dPct":{"type":["number","null"]},"change30dPct":{"type":["number","null"]},"asOf":{"type":["string","null"]}}},"tvlByChain":{"type":"array","items":{"type":"object","required":["chain","tvlUsd"],"properties":{"chain":{"type":"string"},"tvlUsd":{"type":"number"}}}},"auditLinks":{"type":"array","items":{"type":"string"}},"fees":{"type":["object","null"],"properties":{"fees24hUsd":{"type":["number","null"]},"fees7dUsd":{"type":["number","null"]},"fees30dUsd":{"type":["number","null"]},"revenue24hUsd":{"type":["number","null"]},"revenue7dUsd":{"type":["number","null"]},"revenue30dUsd":{"type":["number","null"]}}},"notes":{"type":"array","items":{"type":"string"}},"defillamaUrl":{"type":"string"},"attribution":{"type":"string"},"source":{"type":"array","items":{"type":"string"}}}}},{"type":"object","description":"JSON-RPC 2.0 response envelope. `result.content[0].text` is a JSON-encoded string matching the schema in `x-mcp-result-schema`.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","properties":{"content":{"type":"array","items":{"type":"object","properties":{"type":{"const":"text"},"text":{"type":"string"}}}}}}},"x-mcp-result-schema":{"type":"object","required":["query","count","matches","attribution","source"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","required":["slug","name","category","tvlUsd","chains"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"category":{"type":["string","null"]},"tvlUsd":{"type":["number","null"]},"chains":{"type":"array","items":{"type":"string"}}}}},"attribution":{"type":"string"},"source":{"type":"array","items":{"type":"string"}}}}}]}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/tools/protocol_brief":{"post":{"operationId":"protocol-tvl-brief_protocol_brief_http","summary":"Compact DeFi protocol brief by slug or name: current TVL, 1d/7d/30d TVL change, TVL by chain, category, chains, audit links, fees and revenue for 24h/7d/30d where available, DefiLlama URL. Data by DefiLlama. Not financial advice.","tags":["protocol-tvl-brief"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"protocol":{"type":"string","minLength":1,"maxLength":80,"description":"DefiLlama protocol slug (e.g. aave, uniswap-v3) or exact protocol name"}},"required":["protocol"],"additionalProperties":false},"example":{"protocol":"aave"}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["slug","name","kind","chains","tvl","tvlByChain","auditLinks","fees","defillamaUrl","attribution","source"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string"},"category":{"type":["string","null"]},"website":{"type":["string","null"]},"chains":{"type":"array","items":{"type":"string"}},"tvl":{"type":"object","required":["currentUsd","change1dPct","change7dPct","change30dPct","asOf"],"properties":{"currentUsd":{"type":["number","null"]},"change1dPct":{"type":["number","null"]},"change7dPct":{"type":["number","null"]},"change30dPct":{"type":["number","null"]},"asOf":{"type":["string","null"]}}},"tvlByChain":{"type":"array","items":{"type":"object","required":["chain","tvlUsd"],"properties":{"chain":{"type":"string"},"tvlUsd":{"type":"number"}}}},"auditLinks":{"type":"array","items":{"type":"string"}},"fees":{"type":["object","null"],"properties":{"fees24hUsd":{"type":["number","null"]},"fees7dUsd":{"type":["number","null"]},"fees30dUsd":{"type":["number","null"]},"revenue24hUsd":{"type":["number","null"]},"revenue7dUsd":{"type":["number","null"]},"revenue30dUsd":{"type":["number","null"]}}},"notes":{"type":"array","items":{"type":"string"}},"defillamaUrl":{"type":"string"},"attribution":{"type":"string"},"source":{"type":"array","items":{"type":"string"}}}},"example":{"slug":"aave","name":"Aave","kind":"parent","category":"Lending","website":"https://aave.com","chains":["Ethereum","Base","Arbitrum","Plasma","Avalanche","Monad","BSC","Arc","Polygon","X Layer","Mantle","Gnosis","OP Mainnet","Linea","MegaETH","Sonic","Celo","Scroll","ZKsync Era","Aptos","Metis","Soneium","Fantom"],"tvl":{"currentUsd":18365948587,"change1dPct":-1.93,"change7dPct":-4.08,"change30dPct":0.25,"asOf":"2026-10-09T16:34:35.000Z"},"tvlByChain":[{"chain":"Ethereum","tvlUsd":15311897082},{"chain":"Base","tvlUsd":542086202},{"chain":"Arbitrum","tvlUsd":502438021},{"chain":"Plasma","tvlUsd":428263569},{"chain":"Avalanche","tvlUsd":368671639},{"chain":"Monad","tvlUsd":353680409},{"chain":"BSC","tvlUsd":207710937},{"chain":"Arc","tvlUsd":191563559},{"chain":"Polygon","tvlUsd":156976266},{"chain":"X Layer","tvlUsd":104858949},{"chain":"Mantle","tvlUsd":60470946},{"chain":"Gnosis","tvlUsd":55549633},{"chain":"OP Mainnet","tvlUsd":51665198},{"chain":"Linea","tvlUsd":8640542},{"chain":"MegaETH","tvlUsd":8358078},{"chain":"Sonic","tvlUsd":6190110},{"chain":"Celo","tvlUsd":3591782},{"chain":"Scroll","tvlUsd":1783197},{"chain":"ZKsync Era","tvlUsd":774667},{"chain":"Aptos","tvlUsd":390105},{"chain":"Metis","tvlUsd":278849},{"chain":"Soneium","tvlUsd":104779},{"chain":"Fantom","tvlUsd":4056}],"auditLinks":["https://aave.com/security","https://github.com/aave/aave-v3-horizon/tree/main/audits"],"fees":{"fees24hUsd":1553678,"fees7dUsd":9563346,"fees30dUsd":38180892,"revenue24hUsd":189229,"revenue7dUsd":1208304,"revenue30dUsd":4966704},"notes":["TVL change = latest point vs the latest daily point at or before 1, 7 or 30 days earlier.","Parent protocol: category and audits come from its 7 listed versions."],"defillamaUrl":"https://defillama.com/protocol/aave","attribution":"Data by DefiLlama (https://defillama.com)","source":["https://api.llama.fi/protocol/aave","https://api.llama.fi/summary/fees/aave"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}},"/tools/find_protocol":{"post":{"operationId":"protocol-tvl-brief_find_protocol_http","summary":"Resolves a protocol name or partial name to candidate DefiLlama slugs, ranked by match quality then TVL. Returns slug, name, category, chains and TVL for each. Data by DefiLlama. Not financial advice.","tags":["protocol-tvl-brief"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":80,"description":"Protocol name or partial name, e.g. aave or uniswap"},"limit":{"type":"integer","minimum":1,"maximum":20,"description":"Maximum candidates to return, 1-20","default":5}},"required":["query"],"additionalProperties":false},"example":{"query":"aave","limit":1}}}},"responses":{"200":{"description":"Tool result (plain JSON, not MCP-wrapped)","content":{"application/json":{"schema":{"type":"object","required":["query","count","matches","attribution","source"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","required":["slug","name","category","tvlUsd","chains"],"properties":{"slug":{"type":"string"},"name":{"type":"string"},"category":{"type":["string","null"]},"tvlUsd":{"type":["number","null"]},"chains":{"type":"array","items":{"type":"string"}}}}},"attribution":{"type":"string"},"source":{"type":"array","items":{"type":"string"}}}},"example":{"query":"aave","count":1,"matches":[{"slug":"aave","name":"Aave","category":"Lending","tvlUsd":18365948590,"chains":["Ethereum","Base","Arbitrum","Plasma","Monad","Avalanche","Binance","Polygon","X Layer","Mantle"]}],"attribution":"Data by DefiLlama (https://defillama.com)","source":["https://api.llama.fi/protocols"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"accepts":{"type":"array"}}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]}}}}}