@blueprintaix/blueprint-mcp
OfficialProvides tools for discovering, evaluating, and executing yield strategies on Solana blockchain, with local signing of transactions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@blueprintaix/blueprint-mcpShow me the best yield opportunities on Base for my ETH"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@blueprintaix/blueprint-mcp
An MCP server that connects AI assistants to DeFi yield opportunities across EVM and Solana chains. Discover, evaluate, and execute yield strategies through natural conversation—with transactions signed locally on your machine.
Features
Multi-chain support — Base (EVM) and Solana, with more chains coming soon
Local signing — Private keys never leave your machine
MCP integration — Works with Claude Desktop and other MCP-compatible clients
Intent execution — Automatically signs and submits transactions
Related MCP server: ONEDeFi MCP Server
Quick Start
Add the following to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"blueprint": {
"command": "npx",
"args": ["-y", "@blueprintaix/blueprint-mcp"],
"env": {
"BLUEPRINT_API_KEY": "<your-api-key>",
"EVM_PRIVATE_KEY": "<your-evm-private-key>",
"SOLANA_PRIVATE_KEY": "<your-solana-private-key>"
}
}
}
}Configuration
Variable | Required | Description |
| No | API key for Blueprint services (see below for x402 fallback) |
| One required | Private key for EVM transactions |
| One required | Private key for Solana transactions (base58) |
| No | Custom Base RPC endpoint |
| No | Custom Solana RPC endpoint |
At least one of
EVM_PRIVATE_KEYorSOLANA_PRIVATE_KEYmust be provided.
x402 Payment Fallback
If no BLUEPRINT_API_KEY is provided, the MCP SDK will automatically fall back to using x402 for making payments to call tools. Payments are made on Base using USDC.
When using x402 payments, EVM_PRIVATE_KEY is required to sign the payment transactions.
Get an API Key
Contact meet@emberlabs.io to request a Blueprint API key, or use x402 payments as described above.
Troubleshooting
Server doesnt start? Check the following:
Missing private key for x402 — If using x402 payments (no
BLUEPRINT_API_KEY), ensureEVM_PRIVATE_KEYis setInvalid private key format:
EVM_PRIVATE_KEYmust start with0x(66 characters total)SOLANA_PRIVATE_KEYmust be base58-encoded (~88 characters)
Cached package issue — Clear the npx cache and restart:
rm -rf ~/.npm/_npx
Still stuck? Check the MCP logs in Claude Desktop (~/Library/Logs/Claude/ mcp-server-bp.log)
License
MIT
Available Tools
15 toolsevm-deposit-to-vaultDeposit Asset To An EVM VaultA
Deposit certain USD-equivalent asset to a vault on Ethereum/EVM chains, including: mainnet, polygon, base, optimism, arbitrum, hyperliquid, plasma
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Ethereum/EVM Vault ID to deposit into, in the format of {chainId}:{vaultAddress}, example: 8453:0xx...yy...zz | |
| amountUsd | Yes | Deposit amount (USD) | |
| requestId | No | SYSTEM PARAMETER | 0750ed60-475e-4c96-8772-268ae08f66e8 |
| amountNative | No | Deposit amount in the lowest denomination of the asset token | |
| evmWalletAddress | Yes | User's EVM wallet address to deposit from |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are empty, so the description carries the full burden of behavioral disclosure. It only says 'Deposit certain USD-equivalent asset' without mentioning fund movement, reversibility, approval requirements, or side effects. For a financial transaction tool, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that conveys the action, target, and scope with a useful chain list. No wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a deposit transaction, the description is too thin. It omits how amountUsd relates to amountNative, what 'USD-equivalent asset' means, and what the expected outcome is. With no annotations and no output schema, the description does not provide enough context for safe usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so parameter meanings are already documented in the schema. The description does not add any additional semantics (e.g., relationship between amountUsd and amountNative), so the baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the action clearly: 'Deposit certain USD-equivalent asset to a vault on *Ethereum/EVM chains*' and lists supported networks. This distinguishes it from sibling tools like solana-deposit-to-vault (different chain) and evm-withdraw-from-vault (different action).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description scopes the tool to EVM chains, which provides clear context for when to use it (deposits on Ethereum, Polygon, etc.). However, it does not explicitly name alternatives or state when not to use it, so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
evm-fetch-vaultsFetch EVM VaultsA
Fetch/Search all available vaults from across Ethereum/EVM chains, including: mainnet, polygon, base, optimism, arbitrum, hyperliquid, plasma
Hints: - DO/Encourage to use list of networks to fetch vaults from multiple EVM networks for batch performance optimization. - Result includes basic vaults information (eg. vault name, apy) and transactional identifiers (eg. vaultId, tokenAddress) for further operations.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of vaults to fetch (default: 8). Increase only if user explicitly asks for more vaults. | |
| networks | No | optional networks as a list (defaults to all EVM networks). Use an array like ["network_1","network_2"] or leave empty to select all. | |
| personalised | No | TRUE if the user asks for personalized recommendations based on wallet portfolio, False otherwise | |
| evmWalletAddress | Yes | EVM wallet address to personalize vaults |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the transparency burden. It discloses output contents ('basic vaults information' and 'transactional identifiers') and hints at performance behavior, but does not explicitly state read-only nature, error handling, or prerequisites. This is adequate but not rich.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise paragraphs with no fluff. Purpose is front-loaded, the chain list is compact, and the hints section earns its place by adding practical usage advice. Every sentence contributes value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description adequately covers the tool's purpose, network scope, and output contents (basic info + identifiers). Since there is no output schema, the mention of result fields helps the agent anticipate return values. It stops short of detailing edge cases or performance limits, but is fairly complete for a fetch operation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with each parameter already well-described (e.g., limit default and personalization trigger). The description adds only a performance hint for the networks parameter, which is useful but not necessary beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool 'Fetch/Search all available vaults from across Ethereum/EVM chains' and enumerates supported chains, distinguishing it from the Solana and Sui fetch-vault siblings. The scope and resource are unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear context by encouraging batches network lists for performance optimization, but does not explicitly state when to use this tool over the sibling 'fetch-vault-analytics' or when not to use it. The EVM-specific scope implicitly differentiates from Solana/Sui variants.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
evm-withdraw-from-vaultWithdraw Asset From An EVM VaultA
Withdraw certain USD-equivalent asset from a vault on Ethereum/EVM chains, including: mainnet, polygon, base, optimism, arbitrum, hyperliquid, plasma
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Ethereum/EVM Vault ID to withdraw from, in the format of {chainId}:{vaultAddress}, example: 8453:0xx...yy...zz | |
| amountUsd | Yes | Withdrawal amount (*USD*) | |
| requestId | No | SYSTEM PARAMETER | f1a5a8db-f8d0-4fb2-b1e1-8957e4d1b92a |
| amountNative | No | Withdrawal amount in the lowest denomination of the share token | |
| evmWalletAddress | Yes | User's EVM wallet address to receive withdrawn funds |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full responsibility for disclosing behavioral traits. It only states the action and chain scope, omitting critical details such as whether this is an on-chain transaction, permissions required, side effects, reversibility, or execution status. This is a significant transparency gap for a withdrawal tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence, front-loaded with the action and resource, and efficiently lists the chain scope. While it could be considered slightly vague, it contains no unnecessary filler, earning a high score for structure.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is incomplete for a multi-parameter withdrawal tool. It does not explain the relationship between amountUsd and amountNative, the purpose of requestId, or any prerequisites or failure behavior. With no output schema and sparse annotations, this leaves the agent under-informed about edge cases and execution details.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers 100% of parameters, and the description adds no additional meaning beyond the schema. The baseline of 3 is appropriate because the schema already documents each parameter, so the description does not need to compensate, but it also contributes nothing extra.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (withdraw) and the resource (vault), and explicitly scopes it to Ethereum/EVM chains with a list of supported networks. This distinguishes it from sibling tools targeting Solana or Sui, making the tool's purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context by specifying the supported EVM chains, which implies when this tool should be used. However, it does not explicitly mention alternatives or exclusion criteria (e.g., 'use solana-withdraw-from-vault for Solana'), so it falls short of a fully explicit guideline.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
execute_intentA
Executes an intent by signing and sending the transaction to the blockchain. Use this after receiving an intent from deposit/withdraw tools.
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | The base64-encoded intent string returned by the blueprint tools | |
| chainType | Yes | The chain type of the intent |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden. It discloses the key behavior (signing and sending a transaction to the blockchain) but does not mention consequences such as irreversibility, gas costs, or required prerequisites. The description is concise but lacks additional behavioral context that would help an agent assess the impact.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, both front-loaded with essential information. The first sentence states the purpose, the second provides usage guidance. There is no redundant or filler content; every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the absence of annotations and output schema, the description is fairly complete for a simple execution tool. It explains what it does and when to use it, and the parameter schema covers the inputs. It does not describe return values or downstream effects, but these are not critical for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with both parameters well-described in the schema. The description adds value by clarifying that the 'intent' comes from deposit/withdraw tools, linking the parameter to the sibling tools and usage flow. This goes slightly beyond the schema's generic 'blueprint tools' phrasing.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's function: 'Executes an intent by signing and sending the transaction to the blockchain.' It names a specific verb and resource (executing an intent) and distinguishes from sibling deposit/withdraw tools by explicitly stating it is used after receiving an intent from them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit guidance on when to use the tool: 'Use this after receiving an intent from deposit/withdraw tools.' It gives clear context and sequencing, though it does not name explicit alternatives or exclusions beyond this. The mention of deposit/withdraw tools implies the alternative (using those tools to create intents).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fetch-tokensFetch TokensA
Fetch token details by exact token id, including name, symbol, decimals and USD price
Instructions: - Use this tool before making any asset allocation decisions.
| Name | Required | Description | Default |
|---|---|---|---|
| tokenIds | Yes | Token ids list to fetch details for multiple tokens. Use an array like ["network_1:address_1","network_2:address_2"] | |
| requestId | No | SYSTEM PARAMETER | 8fbc160f-9c03-4ede-8cd5-015bf12bf5d1 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full burden of behavioral disclosure. It merely restates the tool's name ('Fetch token details') and does not address potential side effects, error handling, authentication requirements, or the read-only nature of the operation. This leaves significant gaps for a tool with no annotation safety hints.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded: the first line states the core purpose, and the second line gives a concise usage directive. Every sentence earns its place with no fluff or repetition, making it highly efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite lacking an output schema, the description lists the returned fields (name, symbol, decimals, USD price) and provides usage context ('before asset allocation decisions'). It does not explicitly describe error behavior for invalid token IDs, but given the simplicity of the tool and the rich schema, it is reasonably complete, earning a 4.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 100% coverage for both parameters, including a detailed description of tokenIds with an array example and requestId marked as SYSTEM PARAMETER. The description adds the nuance 'exact token id' and the return fields, but these do not substantially enrich the parameter semantics beyond the schema. Thus the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('Fetch') and resource ('token details by exact token id'), and lists the specific fields returned (name, symbol, decimals, USD price). It does not explicitly contrast with sibling find-tokens, but 'exact token id' implies a distinct lookup behavior from search, giving it a 4 rather than 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The instruction 'Use this tool before making any asset allocation decisions' provides a clear, specific context for when the tool should be invoked. However, it does not mention when not to use it or alternatives (e.g., find-tokens for searching), so it stops short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fetch-vault-analyticsFetch Vault AnalyticsA
Fetch detailed analytics data for vaults, including core vault performance data such as APY
Instructions: - Use this tool before making any asset optimization decisions. - Use this tool when rebalance/compare/analyze vaults.
| Name | Required | Description | Default |
|---|---|---|---|
| vaultIds | Yes | Vault ids list to fetch analytics data for multiple vaults. Use an array like ["vaultId_1","vaultId_2"] | |
| requestId | No | SYSTEM PARAMETER | 81cdb5d9-ba9a-4d61-b686-8dbd7e271078 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are empty, so the description bears full responsibility for behavioral disclosure. It makes clear this is a read-only fetch operation and mentions APY as included data, but it does not disclose return structure, potential errors, or whether any filters or pagination exist. This is adequate but not deeply informative.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact and front-loaded, with the core purpose in the first sentence. The instructions are direct and actionable, adding value without redundancy. Every sentence earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (2 params, no output schema, no annotations), the description is largely complete: it defines the purpose, gives usage guidance, and the schema covers parameter details. It could be improved by describing the output format, but the missing detail is not critical for basic invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers 100% of parameters with detailed descriptions, including the array format for vaultIds and the system nature of requestId. The description adds no additional parameter semantics, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool 'Fetch detailed analytics data for vaults' with a specific focus on 'core vault performance data such as APY.' This distinguishes it from sibling tools like solana-fetch-vaults or evm-fetch-vaults, which are likely focused on retrieving vault lists rather than analytics.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit usage context: 'Use this tool before making any asset optimization decisions' and 'Use this tool when rebalance/compare/analyze vaults.' This gives clear when-to-use guidance, though it does not mention when not to use it or name alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
find-tokensFind TokensA
Finds unknown/unshown tokens on the specified chain/network, this tool returns the token details for transactional operations.
Instructions: - Only use this tool when target/underlying token is not provided in the context / chat history yet
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of tokens information to return (default: 5). Increase only if results are insufficient. | |
| query | Yes | Query to search for token, it can be a sentence, some keywords. Encourage to provide more words in single query for better search. | |
| requestId | No | SYSTEM PARAMETER | 9f96e2eb-237e-4455-b707-f01e9fcf87ff |
| tokenNetwork | Yes | Network to search for the tokens |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden. It clearly signals a read-only discovery operation via 'Finds' and 'returns token details,' and explains the 'unknown/unshown' scope. It does not disclose edge cases like no results or pagination, but for a search tool this is adequate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with a front-loaded verb and resource, followed by a single actionable usage instruction. Every sentence adds value, with no redundancy or filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is complete for a search tool: it explains what it finds, when to use it, and what it returns. With no output schema, stating that it returns token details is sufficient. The schema covers parameter details, so the description does not need to repeat them.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all parameters. The description adds no additional parameter-specific meaning beyond saying 'specified chain/network' and the general query/search purpose. This meets the baseline for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('Finds') and resource ('unknown/unshown tokens on the specified chain/network'), and clarifies that it returns token details for transactional operations. This clearly distinguishes it from sibling tools like fetch-tokens, which likely handles known/shown tokens.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides an explicit when-to-use instruction: 'Only use this tool when target/underlying token is not provided in the context / chat history yet.' This gives a clear contextual trigger and implies not to use it when the token is already known, though it does not name an alternative tool explicitly.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_wallet_addressA
fetch all the wallet addresses of the user
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the burden of explaining behavior. It states the primary action (fetching addresses) but omits details like whether it returns a single address or an array, any authentication requirements, or response format. This leaves ambiguity for the agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one concise sentence, front-loaded with the verb 'fetch' and no redundant words. Every word contributes meaning, making it highly efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple (no params, no output schema), but the description does not specify the return shape or whether addresses are chain-specific. Given the blockchain context from siblings, ambiguity about which chains or address formats are returned makes this only partially complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the baseline is 4. The description adds no parameter semantics because there are none to explain. The schema already covers everything with no properties.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description 'fetch all the wallet addresses of the user' uses a specific verb (fetch), resource (wallet addresses), and scope (of the user). It clearly distinguishes from sibling tools that focus on tokens, vaults, and intent execution.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage: call this tool when needing the user's wallet addresses. However, it provides no explicit when-to-use vs alternatives or exclusions. With no overlapping siblings, implicit guidance is sufficient but not spelled out.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
solana-complete-withdrawSolana Complete WithdrawB
Completes a pending withdrawal for the specified vault on Solana/SVM-chain
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Vault ID that has a pending withdrawal | |
| requestId | No | SYSTEM PARAMETER | df1c13e3-c788-4194-81e0-5cdf251cac22 |
| withdrawalId | Yes | ID of the pending withdrawal | |
| solanaWalletAddress | Yes | User's Solana/SVM wallet address to receive the withdrawn funds |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are empty, so the description carries full responsibility for behavioral disclosure. It does not mention side effects, irreversibility, authorization requirements, or what happens after completion. 'Completes' implies a state change but no further context is provided.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, focused sentence that is front-loaded with the action and resource. There is no wasted wording or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description is minimal and lacks crucial context such as prerequisites (e.g., a prior pending withdrawal), return values, or outcomes. Since there is no output schema, the description is insufficient for a fully autonomous agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, with each parameter having a description, so the base score is 3. The tool description adds no parameter-specific meaning, but the schema adequately explains vaultId, withdrawalId, and solanaWalletAddress.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Completes a pending withdrawal') and the resource ('specified vault on *Solana/SVM-chain*'). It distinguishes from sibling solana-withdraw-from-vault by using 'completes' rather than 'initiates'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given on when to use this tool versus alternatives, nor are any prerequisites or exclusions mentioned. The description only defines what it does, leaving the agent to infer that it should be used after a withdrawal is pending.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
solana-deposit-to-vaultDeposit Asset To A Solana VaultB
Deposit certain USD-equivalent asset into a vault on Solana/SVM-chain
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Solana/SVM Vault ID to deposit into | |
| amountUsd | Yes | Deposit amount (USD) | |
| requestId | No | SYSTEM PARAMETER | 84207182-1283-4067-8c67-ca3d3d57abe0 |
| percentage | No | Percentage of holdings to deposit (0-100). Acts as a additional hint along with the amountUsd & amountNative. | |
| amountNative | No | Deposit amount in the lowest denomination of the asset token | |
| solanaWalletAddress | Yes | User's Solana/SVM wallet address to deposit from |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full responsibility for disclosing behavioral traits. It only says 'deposit' without explaining that this likely executes an on-chain transaction, may be irreversible, requires wallet connectivity/approvals, or what success/failure looks like. Very limited transparency for a financial transaction tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single short sentence, which is concise, but it is under-specified rather than efficiently complete. It lacks critical context about the deposit process, making it less useful despite its brevity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 6 parameters, no output schema, and no annotations, the description is inadequate. It does not clarify how the amount parameters work together, what the vault represents, or the transactional nature. The description is far from complete given the tool's complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The tool description adds no parameter-level meaning beyond the schema; it does not explain the relationship between amountUsd, amountNative, and percentage. The schema itself provides decent descriptions, but the placeholder 'SYSTEM PARAMETER' for requestId is unhelpful and not compensated.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (deposit) and target (vault on Solana/SVM-chain), which distinguishes it from EVM and Sui deposit tools. However, 'certain USD-equivalent asset' is vague and does not specify which asset or how it is determined, slightly impairing clarity.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied by the chain name (Solana/SVM), but no explicit guidance is given about when to choose this tool over sibling tools like 'evm-deposit-to-vault' or 'sui-deposit-to-vault'. The description does not state prerequisites or typical scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
solana-fetch-vaultsFetch Solana VaultsA
Fetch/Search all available vaults from across Solana/SVM-chain
Hints: - Result includes basic vaults information (eg. vault name, apy) and transactional identifiers (eg. vaultId, tokenAddress) for further operations.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of vaults to fetch (default: 6). Increase only if user explicitly asks for more vaults. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It does disclose that results include basic vault information and transactional identifiers, which is useful for downstream operations. However, it does not explicitly state read-only behavior, pagination, or that the default limit of 6 means it does not fetch 'all' unless the limit is increased.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler. The hint sentence provides valuable output context, and the structure is front-loaded with the core purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple, but without an output schema, the description should fully explain the return format. It gives examples of fields but not a complete list, and it does not address the default limit or behavior when no limit is specified. It is adequate for a basic fetch tool but leaves gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema fully documents the single 'limit' parameter with a clear description and default. The tool description adds no parameter-specific meaning beyond the schema, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Fetch/Search') and clearly identifies the resource ('all available vaults from across *Solana/SVM-chain*'). This distinguishes it from EVM and Sui siblings and from action-oriented tools like deposit/withdraw. The hint about result contents reinforces the tool's purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for Solana/SVM vault fetching via the chain qualifier, but it does not provide explicit when-to-use guidance or mention alternatives like fetch-vault-analytics. There are no exclusions or complementary tool references.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
solana-withdraw-from-vaultWithdraw asset from a solana vaultC
Withdraw certain USD-equivalent asset from a vault on Solana/SVM-chain
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Solana/SVM Vault ID to withdraw from | |
| amountUsd | Yes | Withdrawal amount (*USD*) | |
| requestId | Yes | SYSTEM PARAMETER | |
| percentage | No | Percentage of holdings to withdraw (0-100). Acts as a additional hint along with the amountUsd & amountNative. | |
| amountNative | No | Withdrawal amount in the lowest denomination of the share token | |
| solanaWalletAddress | Yes | User's Solana/SVM wallet address to receive the withdrawn funds |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are empty, so the description carries the full burden, but it only restates the basic action with no disclosure of side effects, reversibility, permissions, or post-conditions. It does not go beyond the verb 'withdraw' to explain behavioral traits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with the verb front-loaded and no redundancy. The word 'certain' adds little value and the phrasing is slightly awkward, but it is still appropriately concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 6 parameters, no output schema, and empty annotations, the description provides only a minimal statement. It fails to explain the interplay among amountUsd, amountNative, and percentage, which is critical for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The description mentions 'USD-equivalent asset', which loosely relates to amountUsd, but adds no new semantics beyond what the schema already provides for each parameter.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Withdraw' and the resource 'vault on Solana/SVM-chain', distinguishing it from EVM or Sui siblings. However, the phrase 'certain USD-equivalent asset' is somewhat vague about which asset, so it's not perfect.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. The chain name implies usage for Solana, but no explicit when-to-use or comparison to sibling tools is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
sui-deposit-to-vaultDeposit Asset To A Sui VaultB
Deposit certain USD-equivalent asset into a vault on Sui/SUI-chain
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Sui/SUI Vault ID to deposit into | |
| amountUsd | Yes | Deposit amount (USD) | |
| requestId | No | SYSTEM PARAMETER | adb367f0-4f68-4337-b312-09c86cee2620 |
| amountNative | No | Deposit amount in the lowest denomination of the asset token | |
| suiWalletAddress | Yes | User's Sui wallet address to deposit from |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are empty, so the description carries the full burden. It only says 'deposit', which implies a write operation, but gives no details on side effects, reversibility, prerequisites, or how funds are handled. Minimal transparency beyond the tool name.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, compact sentence with no filler or redundancy. It is appropriately front-loaded and earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Without an output schema or annotations, this 5-parameter transactional tool needs richer context. The description does not explain expected return values, the relationship between amountUsd and amountNative, or what constitutes a 'USD-equivalent asset'. It is inadequate for safe invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so each parameter is already documented. The description adds no parameter-specific context, but the high schema coverage means it does not need to compensate. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a deposit action on a vault, with an explicit chain qualifier 'Sui/SUI-chain' that distinguishes it from sibling tools for Solana/EVM. However, the phrase 'certain USD-equivalent asset' is vague about which asset is involved.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies use for Sui vaults via the chain qualifier, which is clear context. It does not explicitly mention alternatives or exclusions, but the chain-specific wording is sufficient to differentiate from other deposit tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
sui-fetch-vaultsFetch Sui VaultsA
Fetch/Search all available vaults from across Sui/SUI-chain
Hints: - Result includes basic vaults information (eg. vault name, apy) and transactional identifiers (eg. vaultId, tokenAddress) for further operations.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of vaults to fetch (default: 6). Increase only if user explicitly asks for more vaults. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It describes the operation as 'Fetch/Search all available vaults' but does not mention read-only nature, authentication, rate limits, pagination, or the effect of the 'limit' parameter. The hint about returned fields adds some context, but the description is generally thin on operational behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, with two short sections that are front-loaded with the main purpose. The 'Hints' bullet adds useful return-value context without excess. Every sentence earns its place and there is no fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity tool with a single parameter and no output schema, the description covers the core purpose and some return-value details (vault name, apy, vaultId, tokenAddress). However, it omits important behavioral context (e.g., what 'all available' means with a default limit, error behavior, or whether any filtering is possible), leaving some gaps in completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% (the only parameter 'limit' has a description). The description does not add any additional meaning about parameters; it focuses on return values instead. Baseline 3 is appropriate since the schema already documents the parameter adequately.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Fetch/Search') and resource ('all available vaults') scoped to Sui/SUI-chain, distinguishing it from sibling tools like solana-fetch-vaults and evm-fetch-vaults. It leaves no ambiguity about what the tool does.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly scopes the tool to Sui/SUI-chain, providing clear context for when to use it over other chain-specific fetch tools. However, it does not explicitly state exclusions or mention alternatives like 'use solana-fetch-vaults for Solana', so it lacks explicit when-not-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
sui-withdraw-from-vaultWithdraw Asset From A Sui VaultA
Withdraw certain USD-equivalent asset from a vault on Sui/SUI-chain
| Name | Required | Description | Default |
|---|---|---|---|
| vaultId | Yes | Sui/SUI Vault ID to withdraw from | |
| amountUsd | Yes | Withdrawal amount (*USD*) | |
| requestId | No | SYSTEM PARAMETER | 92b8c9f8-afe3-452f-be61-97db0d8d595b |
| amountNative | No | Withdrawal amount in the lowest denomination of the share token | |
| suiWalletAddress | Yes | User's Sui wallet address to receive withdrawn funds |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With empty annotations, the description carries the full burden of behavioral disclosure. It only states the action ('withdraw') without disclosing side effects, permissions, reversibility, or what happens to the vault. This is too minimal for a mutating operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with no wasted words. It is front-loaded with the main action and resource. However, the phrase 'certain USD-equivalent asset' is slightly vague and could be more specific, so it's not a perfect 5.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 5 parameters and no output schema, the description is too brief to provide necessary context. It does not explain when to use amountUsd vs amountNative, what requestId is (beyond schema), or what the response contains. This is inadequate for a withdrawal tool with multiple optional parameters.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema fully documents each parameter. The description adds no additional parameter-level guidance beyond the schema, not even clarifying the relationship between amountUsd and amountNative. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('withdraw'), identifies the resource ('vault'), and scopes it to Sui/SUI-chain, which clearly distinguishes it from sibling tools like solana-withdraw-from-vault and evm-withdraw-from-vault. The mention of 'USD-equivalent asset' further clarifies the asset type.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage for Sui-chain vault withdrawals, providing clear context. However, it does not explicitly state when not to use it or mention alternatives (e.g., using solana-withdraw-from-vault for Solana), so it misses the 'explicit when/when-not' level.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Most tools have clearly distinct purposes, especially the chain-specific vault operations (Solana, EVM, Sui). Minor ambiguity exists between find-tokens and fetch-tokens, and between fetch-vault-analytics and fetch-vaults, but the descriptions provide sufficient guidance.
Naming is inconsistent, mixing hyphenated names (find-tokens, solana-deposit-to-vault) with underscored names (get_wallet_address, execute_intent). Also, both 'fetch' and 'get' are used as verbs, and there is no uniform pattern across chain-specific and generic tools.
15 tools is well-scoped for a multi-chain vault management server. Each tool serves a necessary function, covering three chains with fetch/deposit/withdraw operations plus supporting utilities for tokens, analytics, wallet address, and intent execution.
The core lifecycle is covered: fetching vaults, depositing, withdrawing, and analytics. Minor gaps exist, such as the lack of a complete-withdraw tool for EVM and Sui chains (only Solana has it) and no explicit portfolio/balance tool, but agents can work around these.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains
Passive income opportunity scanner. Yield analysis and portfolio optimization for AI agents.
Gasless, MEV-protected onchain token swaps for AI agents on 14 EVM chains, built on CoW Protocol.
Related MCP Servers
- AlicenseBqualityCmaintenanceTransforms AI assistants into autonomous crypto trading agents with real-time market analysis, portfolio management, and trade execution across 17+ blockchains.322352MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered DeFi operations across Ethereum, Polygon, and Solana with automated portfolio optimization, risk assessment, and yield farming strategies. Provides intelligent portfolio diagnostics, investment strategy generation, and multi-chain DeFi protocol integration through natural language.
- AlicenseCqualityDmaintenanceEnables AI agents to interact with cryptocurrency ecosystems through wallet management, trading operations (swaps, DCA, limit orders), staking, and multi-chain support starting with Solana.37GPL 3.0
- AlicenseCqualityCmaintenanceEnables AI agents to interact with any EVM-compatible blockchain through natural language, supporting token swaps, cross-chain bridges, staking, lending, governance, gas optimization, and portfolio tracking across networks like Ethereum, BSC, Polygon, Arbitrum, and more.1006339Inno Setup
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/BlueprintAIx/blueprint-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server