{"apiVersion":"v1","directorySlug":"lienfi-mcp-b4a9bb5b20","title":"LienFi","description":"Access tokenized tax liens and tax deeds with defined terms, real estate-linked collateral, and 24/7 marketplace liquidity. Built on Base.","pageUrl":"https://www.mcpbundles.com/skills/lienfi-mcp-b4a9bb5b20","connectPath":"importable","connectAction":"import_server","catalogListing":false,"bundleSlug":null,"listingKind":"remote_mcp","kind":"provider","transportUrl":"https://api.lienfi.com/api/v1/mcp","hostedMcpUrl":null,"toolCount":10,"toolInventoryStatus":"observed","refreshedAt":"2026-11-03T13:26:00.516172+00:00","registryName":"com.lienfi/lienfi-mcp-b4a9bb5b20","registryVersion":"2026.11.3","registryEligible":true,"tools":[{"name":"market_overview","description":"Inventory shape for the LienFi marketplace: how many liens are listed, which states and counties they are in, and the price / rate / LTV bounds. Cheap and unauthenticated — call this first to see what is available before searching.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"logicalName":"market_overview","displayName":"market_overview","title":"market_overview","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"search_liens","description":"Screen listed liens and return a shortlist ranked by NET yield — after LienFi’s share of the gain — rather than by the gross APY the API publishes. Liens under a month from maturity come back in a separate maturing_soon list carrying NO per-year rate: a certificate pays once, so there is no year to restate the payoff over, and annualizing one puts a trivial gain at the top of the ranking. Compare those on net_return_pct. Liens that cannot be scored at all are counted, not silently dropped. Redem","inputSchema":{"type":"object","properties":{"limit":{"type":"number"},"states":{"type":"string"},"max_ltv":{"type":"number"},"counties":{"type":"string"},"budget_usd":{"type":"number"},"min_interest":{"type":"number"},"property_types":{"type":"string"}},"additionalProperties":false},"logicalName":"search_liens","displayName":"search_liens","title":"search_liens","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"get_lien","description":"The full record for one lien, including the redemptive-value projection and the fee rate that applies to it. Use after search_liens to inspect a candidate.","inputSchema":{"type":"object","required":["lien_id"],"properties":{"lien_id":{"type":"string"}},"additionalProperties":false},"logicalName":"get_lien","displayName":"get_lien","title":"get_lien","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"agent_status","description":"Whether this agent wallet is authorized to buy, when that authorization expires, and what it holds. Call this first when a purchase is refused — it reports authorization and balances, which covers most refusals.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"logicalName":"agent_status","displayName":"agent_status","title":"agent_status","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"quote_lien","description":"An INDICATIVE price for one lien, for this agent wallet, plus whether the wallet can afford it. No signature is minted, so this cannot be used to buy and the price is re-quoted at purchase. Read-only: nothing is approved and nothing is bought.","inputSchema":{"type":"object","required":["lien_id"],"properties":{"lien_id":{"type":"string"}},"additionalProperties":false},"logicalName":"quote_lien","displayName":"quote_lien","title":"quote_lien","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"my_positions","description":"Liens currently owned by this agent wallet, valued LIVE rather than from the stored snapshot columns, and cross-checked against onchain ownership. Rows the database attributes to you that the chain does not confirm are reported separately, not hidden.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"logicalName":"my_positions","displayName":"my_positions","title":"my_positions","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"prepare_purchase","description":"Step 1 of 3 to buy a lien. Checks everything a purchase would refuse on — authorization, the per-purchase cap, consents, sanctions, your ceiling, and whether the wallet can afford it — then RESERVES the purchase and returns the acknowledgment typed data for your wallet to sign (eth_signTypedData_v4). Nothing is signed by LienFi and nothing is written to the consent record yet; that happens in confirm_purchase. One purchase in flight per wallet: if another lien already has a live quote you get pu","inputSchema":{"type":"object","required":["lien_id","max_total_usdc"],"properties":{"lien_id":{"type":"string"},"max_total_usdc":{"type":"number"}},"additionalProperties":false},"logicalName":"prepare_purchase","displayName":"prepare_purchase","title":"prepare_purchase","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"confirm_purchase","description":"Step 2 of 3. Records your signed acknowledgment, mints the LienFi price signature (valid 300 s), and returns UNSIGNED transactions for your wallet to submit IN ORDER, each after the previous one is mined with status success: approve (exactly the total), buyNFT, and setApprovalForAll for the vault when not yet granted (without it the lien cannot be redeemed). LienFi signs nothing else and submits nothing. Then call report_purchase.","inputSchema":{"type":"object","required":["reservation_id","acknowledgment_signature"],"properties":{"reservation_id":{"type":"string"},"acknowledgment_signature":{"type":"string"}},"additionalProperties":false},"logicalName":"confirm_purchase","displayName":"confirm_purchase","title":"confirm_purchase","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"report_purchase","description":"Step 3 of 3. Report the buyNFT transaction hash and LienFi reads the receipt: a success settles the reservation, a revert releases it and marks the acknowledgment failed, a pending transaction is reported as pending — retry. Or report { failed: true, reason } if you never submitted, which releases the reservation so the wallet can buy again. The indexer settles the record on its own too; reporting just makes it immediate.","inputSchema":{"type":"object","required":["reservation_id"],"properties":{"failed":{"type":"boolean"},"reason":{"type":"string"},"tx_hash":{"type":"string"},"reservation_id":{"type":"string"}},"additionalProperties":false},"logicalName":"report_purchase","displayName":"report_purchase","title":"report_purchase","annotations":{"untrustedContentHint":true,"readOnlyHint":true}},{"name":"register_agent","description":"Bind this agent wallet to the operator authorization carried in your Authorization header. Pass the key proof and the consent-v2 acceptances your wallet signed, exactly as the authorization page lays them out; this is POST /agents/register without leaving MCP. Idempotent for the same operator. Required once before any wallet-scoped tool works.","inputSchema":{"type":"object","required":["agent_key_proof","agent_consents"],"properties":{"label":{"type":"string"},"agent_consents":{"type":"array","items":{"type":"object"}},"agent_key_proof":{"type":"object"}},"additionalProperties":false},"logicalName":"register_agent","displayName":"register_agent","title":"register_agent","annotations":{"untrustedContentHint":true,"readOnlyHint":true}}],"toolSource":"directory_preview","agentAction":"both","installLinks":[{"id":"cursor","label":"Cursor","href":"cursor://anysphere.cursor-deeplink/mcp/install?name=LienFi&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcGkubGllbmZpLmNvbS9hcGkvdjEvbWNwIn0%3D"},{"id":"vscode","label":"VS Code","href":"vscode:mcp/install?%7B%22name%22%3A%22LienFi%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.lienfi.com%2Fapi%2Fv1%2Fmcp%22%7D"},{"id":"vscode-insiders","label":"VS Code Insiders","href":"vscode-insiders:mcp/install?%7B%22name%22%3A%22LienFi%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapi.lienfi.com%2Fapi%2Fv1%2Fmcp%22%7D"},{"id":"claude-web","label":"Claude.ai","href":"https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=LienFi&connectorUrl=https%3A%2F%2Fapi.lienfi.com%2Fapi%2Fv1%2Fmcp"},{"id":"codex","label":"Codex","copyText":"codex mcp add \"LienFi\" --url \"https://api.lienfi.com/api/v1/mcp\""},{"id":"chatgpt","label":"ChatGPT","href":"https://www.mcpbundles.com/docs/integrations/chatgpt"}],"catalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/lienfi-mcp-b4a9bb5b20","callUrl":"https://www.mcpbundles.com/api/directory/v1/servers/lienfi-mcp-b4a9bb5b20/tools/{tool}","mcpServerUrl":"https://api.lienfi.com/api/v1/mcp","liveCatalogUrl":"https://www.mcpbundles.com/api/directory/v1/servers/lienfi-mcp-b4a9bb5b20?live=1"}