Give your AI agent real-time access to on-chain token vesting data – every wallet, every protocol, every chain. Query in natural language via MCP, or call the REST API directly.
What is MCP?
The Model Context Protocol (MCP) is an open standard by Anthropic that lets AI agents call external tools natively – without writing API glue code. Install @vestream/mcp and your agent can query vesting data the same way it reasons about anything else: in natural language.
MCP Tools
Install the MCP server and your agent immediately has read access to every wallet, stream, and upcoming unlock on the free tier – plus webhook subscription management on Pro.
Webhook subscriptions are now an MCP tool
Three new tools – list_webhook_subscriptions, create_webhook_subscription, delete_webhook_subscription – let your agent set up server-to-server alerts the moment a matching unlock fires. HMAC-signed, filterable by wallet / protocol / chain. Pro tier. Update with npx -y @vestream/mcp@latest.
get_wallet_vestingsGet all token vesting streams for a wallet (EVM or Solana) across all 11+ supported protocols and 9+ chains. Returns normalised data: token, locked/claimable/withdrawn amounts, schedule dates, cliff time, and next unlock.
Parameters
addressstringWallet address – EVM 0x… or Solana base58 pubkeyprotocolstringoptionalFilter by protocol: sablier, hedgey, uncx, unvest, superfluid, team-finance, pinksale, streamflow, jupiter-lock, smithiichainstringoptionalFilter by chain ID: 1 (Ethereum), 56 (BSC), 137 (Polygon), 8453 (Base), 101 (Solana)active_onlybooleanoptionalOnly return streams not yet fully vestedExample call
get_wallet_vestings({
address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
active_only: true
})get_upcoming_unlocksForecast all token unlock events for a wallet within a future time window. Returns cliff completions, tranche unlocks, and linear stream endings sorted by date – ideal for scheduling claims or building alerts.
Parameters
addressstringWallet address – EVM 0x… or Solana base58 pubkeydaysnumberoptionalLookahead window in days (default: 30, max: 365)protocolstringoptionalFilter by protocol (any of the 12+ protocols above)Example call
get_upcoming_unlocks({
address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
days: 14
})get_streamGet full details for a single vesting stream by its composite ID. Use get_wallet_vestings first to discover stream IDs, then drill into a specific stream for complete unlock steps and claim history.
Parameters
stream_idstringFormat: protocol-chainId-nativeId, e.g. 'sablier-1-12345' or 'uncx-8453-99'Example call
get_stream({
stream_id: "sablier-8453-12345"
})list_webhook_subscriptionsPro tier. List the webhook subscriptions registered to the caller's API key. Each subscription describes a URL Vestream POSTs to when a matching upcoming-unlock fires.
Parameters
Example call
list_webhook_subscriptions({})create_webhook_subscriptionPro tier. Register a new webhook subscription. Returns the signing secret ONCE – store it for HMAC verification. Vestream POSTs to the URL with X-Vestream-Signature on each matching event.
Parameters
urlstringDestination URL (https in production)wallet_filterarrayoptionalRestrict to these wallet addressesprotocol_filterarrayoptionalRestrict to these protocols (slug list)chain_filterarrayoptionalRestrict to these chain IDshours_beforenumberoptionalLookahead window in hours (1-168, default 24)Example call
create_webhook_subscription({
url: "https://your.app/webhooks/vestream",
protocol_filter: ["sablier", "streamflow"],
hours_before: 6
})delete_webhook_subscriptionPro tier. Permanently delete a webhook subscription by its UUID. Use list_webhook_subscriptions to discover IDs.
Parameters
subscription_idstringUUID returned by list_webhook_subscriptionsExample call
delete_webhook_subscription({
subscription_id: "9c8e..."
})In action
get_upcoming_unlocks{
"address": "0x3f5CE96daD0cf8781AB329C5af6D6595beEf9A26",
"days": 14
}{
"unlocks": [
{
"date": "2026-05-02",
"token": "NOVA",
"amount_usd": 18420.00,
"protocol": "sablier",
"chain": "base",
"type": "cliff"
},
{
"date": "2026-05-08",
"token": "FLUX",
"amount_usd": 4210.50,
"protocol": "hedgey",
"chain": "ethereum",
"type": "tranche"
}
],
"total_usd": 22630.50,
"window_days": 14
}Setup
No SDK to install. No API glue code. Just add to your config and start querying.
{
"mcpServers": {
"vestream": {
"command": "npx",
"args": ["-y", "@vestream/mcp"],
"env": {
"VESTREAM_API_KEY": "vstr_live_..."
}
}
}
}{
"mcpServers": {
"vestream": {
"command": "npx",
"args": ["-y", "@vestream/mcp"],
"env": {
"VESTREAM_API_KEY": "vstr_live_..."
}
}
}
}What it looks like in practice
You
Show me everything vesting for vitalik.eth.
Claude · via Vestream MCP
Found 3 active streams across 2 protocols on Ethereum. The largest is a Sablier linear vesting of 8,500 USDC running until Sept 2026 (≈ 14% vested). Next unlock event: a Hedgey tranche on May 14 unlocking ~12,000 OP. Want the full schedule?
You
When should I claim my APE before the next cliff?
Claude · via Vestream MCP
Your Sablier APE stream has a cliff completing in 6 days, releasing ~4,200 APE. Gas is currently 23 gwei; predicted to drop to ~14 gwei overnight. Recommend claiming after midnight UTC – you save roughly $18 in gas at current prices.
You
What's unlocking across my 3 wallets in the next 30 days?
Claude · via Vestream MCP
12 unlock events across 3 wallets – total locked value coming online: $63,418. Biggest single event: a UNCX cliff on May 9 (28% of the total). Want me to draft a calendar export or set up a watch on the day before each?
Sample exchanges, lightly edited. Set up your own in a Claude Desktop chat in 60 seconds.
Use cases
Monitor wallets 24/7 and ping Slack, Telegram, or email the moment a cliff or tranche unlock is due – before you'd normally even check.
Ask your agent 'what's my total locked value across all my wallets?' and get a structured, cross-protocol breakdown in seconds.
Pull the full global vesting schedule for any token – who's unlocking, when, and how much – to model selling pressure before it hits the market.
Generate audit-ready vesting reports for any wallet or team – cliff dates, tranches, claimed amounts – structured and exportable on demand.
Combine upcoming unlock data with on-chain prices to automatically evaluate whether to hold, hedge, or exit a position as vesting cliffs approach.
Embed Vestream vesting data inside any product – wallets, portfolio trackers, DAO tools – with a single API call and zero normalisation work.
Find us
@vestream/mcp
Install via npx – no global install required. Works anywhere Node.js runs.
npx -y @vestream/mcpmodelcontextprotocol/servers
Listed in the official Anthropic MCP server registry for Claude users.
github.com/modelcontextprotocol/serverssmithery.ai
Discoverable in the Smithery MCP marketplace for agent builders.
smithery.ai/server/vestreamGet an API key, add the MCP server to your config, and start querying on-chain vesting data in minutes.