eCommerce
lienfi.com
Access and search tax lien listings, get detailed lien records, and obtain quotes and agent authorization status for purchasing within the LienFi marketplace.
ENDPOINT 1
https://api.lienfi.com/api/v1/mcp
MCP server metadata
- Name
- lienfi
- Version
- 0.1.0
Tools for researching LienFi tax lien certificates. WE HOLD NO KEY. This server never signs and never submits a transaction for you. Tools return authorization state, balances, positions and an indicative quote for the wallet your operator authorized. Buying over MCP is not built yet; an authorized agent can buy over REST from its own wallet. Every yield the underlying API returns is GROSS: the platform takes a share of the gain over the purchase price when a lien redeems. Rank on net_apy, not on the API apy — they are different derivations, not the same number before and after a fee. A lien under a month from maturity has NO net_apy: a certificate pays once, so there is no year to restate the payoff over. search_liens returns those separately, ranked on net_return_pct. Research needs no credential: market_overview, search_liens and get_lien work with no Authorization header. Anything wallet-scoped needs one. When a tool refuses, the JSON body carries a stable `error.code`; on not_registered it also carries `handoff_url` — surface that link to your operator and STOP. Retrying will not register you, because that step happens in a browser. Call agent_status when a wallet-scoped tool refuses: it reports authorization and balances, which covers most refusals.
Known tools 6
market_overviewInventory shape for the LienFi marketplace: how many liens are listed, which states and counties they are in, and the price / rate / LTV bounds.
Inferred read-onlysearch_liensScreen 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.
Inferred read-onlyget_lienThe full record for one lien, including the redemptive-value projection and the fee rate that applies to it.
Inferred read-onlyagent_statusWhether this agent wallet is authorized to buy, when that authorization expires, and what it holds.
Inferred read-onlyquote_lienAn INDICATIVE price for one lien, for this agent wallet, plus whether the wallet can afford it.
Inferred read-onlymy_positionsLiens currently owned by this agent wallet, valued LIVE rather than from the stored snapshot columns, and cross-checked against onchain ownership.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.lienfi]
url = "https://api.lienfi.com/api/v1/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"lienfi": {
"type": "http",
"url": "https://api.lienfi.com/api/v1/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: lienfi
Remote MCP URL: https://api.lienfi.com/api/v1/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"lienfi": {
"url": "https://api.lienfi.com/api/v1/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"lienfi": {
"type": "http",
"url": "https://api.lienfi.com/api/v1/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "lienfi",
"transport": "streamable-http",
"url": "https://api.lienfi.com/api/v1/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.