MCP Server DeFi Tools — Syenite Reference

Q: Do I need an API key to use Syenite?

No API key is needed for standard use. The endpoint https://syenite.ai/mcp is open with a rate limit of 30 requests per minute per IP. For production workloads requiring higher throughput, contact Syenite.

This page is a reference for developers connecting to Syenite for the first time. It covers what an MCP server is, why DeFi tools via MCP are useful for agents, the full tool list, and how to install and connect.

what is an mcp server

MCP (Model Context Protocol) is an open standard that lets AI models call external tools. An MCP server exposes a set of named tools at a single HTTPS endpoint. Clients — Cursor, Claude Desktop, the OpenAI Agents SDK, LangChain with MCP support, Coinbase AgentKit — send JSON-RPC tools/call requests; the server executes the tool and returns a structured result. One MCP server can expose dozens of tools, so a single endpoint URL gives an agent access to an entire capability surface without per-tool API wiring.

why defi tools via mcp

DeFi data is structured and action-oriented: interest rates, health factors, swap quotes, and yield APYs are all numeric values that agents can reason over. DeFi actions (supply, borrow, swap) produce unsigned transaction calldata that agents can prepare without custody risk. MCP is the natural transport for this: agent-native, composable, real-time, and framework-agnostic.

Syenite bundles lending intelligence (rates, risk, position monitoring), yield discovery, swap and bridge quotes, wallet tools, and prediction market access under one endpoint. An agent that connects once can execute any DeFi workflow without additional API integrations.

full tool reference

Tool name	Description	Category	Chains
`syenite.help`	Service info, tool list, supported chains, and yield sources. No parameters.	Meta	—
`lending.rates.query`	Live borrow and supply rates across Aave v3, Morpho Blue, and Spark for a given collateral and borrow asset.	Lending	Ethereum, Arbitrum, Base
`lending.market.overview`	Aggregate market view: TVL, utilization, rate ranges, and available liquidity per protocol.	Lending	Ethereum, Arbitrum, Base
`lending.risk.assess`	Risk assessment for a proposed position: liquidation price, safety margin, annual cost, risk score.	Lending	Ethereum, Arbitrum, Base
`lending.position.monitor`	Current position details for a wallet: health factor, LTV, collateral value, borrow balance.	Lending	Ethereum, Arbitrum, Base
`lending.supply`	Returns unsigned calldata to supply collateral to Aave v3 or Spark.	Lending execution	Ethereum
`lending.borrow`	Returns unsigned calldata to borrow against supplied collateral.	Lending execution	Ethereum
`lending.withdraw`	Returns unsigned calldata to withdraw supplied collateral.	Lending execution	Ethereum
`lending.repay`	Returns unsigned calldata to repay a borrow position.	Lending execution	Ethereum
`yield.opportunities`	Discover yield opportunities across vaults, LSTs, savings rates, and basis trades.	Yield	Ethereum, Arbitrum, Base
`yield.assess`	Risk/return assessment for a specific yield opportunity: protocol risk, liquidity, APY sustainability.	Yield	Ethereum, Arbitrum, Base
`swap.quote`	Optimal swap quote: expected output, price impact, gas estimate, unsigned calldata.	Swap	30+ EVM chains
`swap.multi`	Batch swap quotes for multiple pairs in one call.	Swap	30+ EVM chains
`swap.status`	Bridge or cross-chain swap status by transaction hash.	Swap	30+ EVM chains
`wallet.balances`	Multi-chain token balances for a wallet address.	Wallet	Any EVM chain
`gas.estimate`	Gas cost estimate for swaps, bridges, and contract calls.	Wallet	Any EVM chain
`tx.verify`	Pre-signing transaction verification: contract check, approval scope, risk flags.	Trust layer	Any EVM chain
`tx.simulate`	Simulate transaction outcome before signing: state diff, token movements.	Trust layer	Any EVM chain
`tx.guard`	Policy-based transaction guard: block or flag transactions that violate spend limits or allowlist rules.	Trust layer	Any EVM chain
`tx.receipt`	Post-signing transaction confirmation and decoded receipt.	Trust layer	Any EVM chain
`alerts.watch`	Register a position for health factor and LTV monitoring.	Alerts	Ethereum, Arbitrum, Base
`alerts.check`	Poll for active alerts on watched positions.	Alerts	Ethereum, Arbitrum, Base
`alerts.list`	List all active watches for the session.	Alerts	—
`alerts.remove`	Stop monitoring a position by watch ID.	Alerts	—
`strategy.carry.screen`	Screen for positive-carry strategies: supply APY exceeds borrow APY.	Strategy	Ethereum, Arbitrum, Base
`prediction.trending`	Trending prediction markets by volume and open interest.	Prediction	Polygon, Ethereum
`prediction.search`	Search prediction markets by keyword or category.	Prediction	Polygon, Ethereum
`prediction.book`	Order book depth and liquidity for a prediction market.	Prediction	Polygon, Ethereum
`prediction.signals`	Market signals and sentiment indicators for prediction markets.	Prediction	Polygon, Ethereum
`find.strategy`	Composite strategy search across lending, yield, and prediction tools.	Strategy	Multi-chain

install and connect

Endpoint: https://syenite.ai/mcp. No API key required for standard use. Rate limit: 30 requests per minute per IP.

Cursor / Claude Desktop

{
  "mcpServers": {
    "syenite": {
      "url": "https://syenite.ai/mcp"
    }
  }
}

OpenAI Agents SDK

from openai.agents import MCPServer

server = MCPServer(url="https://syenite.ai/mcp")
agent = Agent(tools=[server])

Verify the connection

Call syenite.help with no arguments. It returns the server version, full tool list, supported chains, and data freshness information. If you see a valid response, the connection is working.

faq

What is an MCP server?

MCP (Model Context Protocol) is an open standard that lets AI models call external tools. An MCP server exposes a set of named tools at a single endpoint. Clients like Cursor, Claude Desktop, and the OpenAI Agents SDK send tool-call requests; the server executes them and returns structured results.

Which chains does Syenite support?

Lending tools support Ethereum mainnet, Arbitrum, and Base. Swap and bridge tools support 30+ EVM chains. Wallet balance queries work on any EVM chain. Check the tool-specific docs for per-tool chain coverage.

Do I need an API key to use Syenite?

No API key is needed for standard use. The endpoint https://syenite.ai/mcp is open with a rate limit of 30 requests per minute per IP. For production workloads requiring higher throughput, contact Syenite.

Does Syenite submit transactions on my behalf?

No. Transaction tools return unsigned calldata. Your wallet or signing infrastructure submits the transaction. Syenite never holds private keys or custody of assets.