Skip to main content
Glama
eltociear

tokenguard-mcp

by eltociear

tokenguard-mcp

MCP (Model Context Protocol) server for crypto/DeFi data — 10 tools, no API keys required.

Tools

Tool

Description

get_token_price

Price, market cap, 24h change for any token (CoinGecko)

get_gas_fees

Ethereum gas fees (fast/standard/slow)

get_fear_greed

Crypto Fear & Greed Index

get_defi_tvl

DeFi protocol TVL from DeFiLlama

get_mempool

Bitcoin mempool stats & fee rates

get_nft_floor

NFT collection floor price & market data

get_stablecoins

Top stablecoins by circulating supply

get_global_market

Global crypto market overview

get_trending

Trending coins & NFTs on CoinGecko

get_lightning_stats

Bitcoin Lightning Network stats

Related MCP server: Desk3 MCP Server

Usage

{
  "mcpServers": {
    "tokenguard": {
      "command": "npx",
      "args": ["@eltociear/tokenguard-mcp"]
    }
  }
}

Or run directly:

npx @eltociear/tokenguard-mcp

Data Sources

All free, no API keys required:

Live API

Full 40+ route API with x402 micropayments: eltociear-tokenguard.hf.space

License

MIT

Professional audit services

Maintained by the same author — paid services on Polar (Stripe checkout):

Full catalog: polar.sh/eltociear

Also live: clean-read ($0.005 / call)

Same operator, same x402 rails: clean-read turns any URL into clean Markdown for AI agents — fetches the page, strips nav/ads/boilerplate (trafilatura), returns the main content with title and word count. POST https://eltociear-skill-audit.hf.space/read — $0.005 USDC on Base, no signup.

Available Tools

10 tools
get_defi_tvlAInspect

Get Total Value Locked (TVL) for a DeFi protocol from DeFiLlama

ParametersJSON Schema
NameRequiredDescriptionDefault
protocolYesProtocol slug (e.g. 'uniswap', 'aave', 'curve', 'lido')

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It adequately discloses the read-only nature of fetching TVL data, but does not elaborate on potential rate limits, response structure, or data freshness. No contradictions with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence with no extraneous words. Every part is informative and earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and a straightforward return value (TVL), the description is largely complete. It does not specify the return format, but the context of 'TVL' implies a numeric value, making it adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the description adds no further meaning beyond the schema's description of the 'protocol' parameter. The example values in the schema provide sufficient clarity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get', the resource 'Total Value Locked (TVL) for a DeFi protocol', and the source 'DeFiLlama'. It effectively distinguishes from sibling tools like get_token_price or get_gas_fees by specifying TVL.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for retrieving TVL data but provides no explicit guidance on when to use this tool versus alternatives, nor does it mention prerequisites or exclusions. The context is implied by the tool's purpose.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_fear_greedAInspect

Get the Crypto Fear & Greed Index (0=Extreme Fear, 100=Extreme Greed)

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoNumber of historical days to return (default: 7)

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so description must cover behavioral aspects. It states the index range but does not disclose whether the operation is read-only, rate limits, data freshness, or any side effects. For a simple read tool, this is minimally adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence with no wasted words. All important information is front-loaded: action, resource, and value interpretation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple index with one optional parameter and no output schema, the description is nearly complete. It explains the meaning of the values, though it could be improved by noting that historical data is returned as an array.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema already documents the single parameter 'limit' with description and default. The tool description adds no additional meaning beyond schema coverage of 100%.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly identifies the tool as retrieving the Crypto Fear & Greed Index with its numeric range interpretation. Distinguishes from sibling tools that provide different crypto data (price, gas fees, TVL, etc.).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. The sibling list implies it's for market sentiment, but no direct comparison or context is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_gas_feesAInspect

Get current Ethereum gas fees (fast/standard/slow in Gwei)

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/5.0
Behavior3/5

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 indicates a read-only operation ('Get current...') but does not elaborate on data freshness, rate limits, or any side effects. It is minimal but sufficient for a zero-parameter, read-only tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that front-loads the key action and result. Every word is valuable with no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has zero parameters, no output schema, and is relatively simple, the description fully covers what the tool does and what it returns. Sibling tools provide enough context to differentiate, making this description complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters in the input schema, so baseline score is 4. The description does not need to add parameter information, and it appropriately focuses on the output (fast/standard/slow in Gwei).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get', the resource 'current Ethereum gas fees', and specifies the output format 'fast/standard/slow in Gwei'. It distinctly sets this tool apart from sibling tools like get_token_price, get_fear_greed, etc., which cover different crypto metrics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for fetching gas fees but does not provide explicit guidance on when to use this tool versus alternatives, nor does it mention any prerequisites, caveats, or exclusions. It is adequate but lacks explicit direction.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_global_marketAInspect

Get global crypto market overview: total market cap, BTC dominance, active currencies

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It describes the output (market cap, BTC dominance, active currencies) but omits any behavioral traits such as rate limits, caching, or data freshness. For a simple read-only tool, basic transparency is present but lacks depth.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, focused sentence that lists the key offerings with no filler. Every part contributes meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters and no output schema, the description adequately covers its purpose and outputs. It could mention data sourcing or update frequency but is sufficient for a simple market overview tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, and schema coverage is effectively 100%. The description adds value by explicitly listing the returned data, which compensates for the absence of parameter documentation. Baseline for 0 params is 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves a global crypto market overview with specific data points (market cap, BTC dominance, active currencies). It distinguishes itself from siblings like get_token_price (specific token) and get_trending (trending tokens).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for global market data but does not explicitly state when to use versus alternatives like get_token_price or get_defi_tvl. No exclusions or context are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_lightning_statsAInspect

Get Bitcoin Lightning Network statistics: node count, channel count, total capacity

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It only states it 'Get[s]' statistics, with no mention of side effects, authentication, rate limits, or data freshness. Minimal disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, no unnecessary words, immediately informative. Front-loads the action and resource.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with no output schema or annotations, the description lists what metrics are returned but lacks details on data source, update frequency, or whether it returns current or historical data. Adequate but not complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist, so baseline is 4. Description adds value by specifying the exact statistics returned (node count, channel count, total capacity) beyond the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool retrieves Bitcoin Lightning Network statistics, listing specific metrics (node count, channel count, total capacity). It is distinct from sibling tools which focus on other crypto data.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied for obtaining Lightning Network stats, but no explicit guidance on when to prefer this over alternatives or exclusions. Sibling tool names provide domain context, but no direct comparison.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_mempoolAInspect

Get Bitcoin mempool statistics: pending transactions, fee rates, block height

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must convey behavioral traits. It only lists output contents but does not disclose that the tool is read-only, whether it requires network access, if it returns cached data, or any other side effects. The transparency is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single focused sentence with no wasted words. It front-loads the core purpose and lists key data points efficiently. Perfect conciseness for a simple tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters, no output schema, and no annotations, the description is minimal. It tells what data is returned but does not specify format, update frequency, or whether the statistics are for the main chain. It is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are no parameters, so the schema already covers everything. The description adds value by indicating the tool returns pending transactions, fee rates, and block height, which is useful context beyond the empty schema. Following the 0-params baseline of 4, the score is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves Bitcoin mempool statistics and lists specific items (pending transactions, fee rates, block height), making its purpose distinct from sibling tools like get_gas_fees or get_fear_greed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

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. It does not mention use cases, prerequisites, or exclusions, leaving the agent to infer context from the tool name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_nft_floorAInspect

Get NFT collection floor price and market stats from CoinGecko

ParametersJSON Schema
NameRequiredDescriptionDefault
collectionYesCoinGecko NFT collection slug (e.g. 'bored-ape-yacht-club', 'cryptopunks')

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It indicates a read-only fetch from CoinGecko but omits details like rate limits, data freshness, or authentication needs. This is adequate but not comprehensive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that directly conveys purpose and source without redundancy or unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and no output schema, the description provides sufficient context (purpose, source). Could be enhanced by listing which market stats are included, but overall adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the parameter description includes examples. The tool description adds minimal additional meaning beyond the schema, so baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it gets NFT collection floor price and market stats from CoinGecko, distinguishing it from sibling tools like get_token_price or get_gas_fees which serve different purposes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide explicit guidance on when to use this tool versus alternatives, though the purpose is implied. No exclusions or conditional usage are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_stablecoinsAInspect

Get top stablecoins by circulating supply from DeFiLlama

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoNumber of stablecoins to return (default: 10)

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations; description implies read operation but lacks details on pagination, rate limits, or data freshness. Adequate but minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, front-loaded, no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Simple tool with one optional param and no output schema. Description covers core purpose and source, but lacks return format details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Single parameter 'limit' fully described in schema. Description adds no extra meaning beyond default value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states action (get), resource (top stablecoins), criteria (by circulating supply), and source (DeFiLlama). Distinct from siblings like get_token_price or get_defi_tvl.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use vs alternatives. Sibling tools exist but no context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_token_priceAInspect

Get current price, market cap, 24h change, and volume for any cryptocurrency

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenYesCoinGecko token ID (e.g. 'bitcoin', 'ethereum', 'solana', 'uniswap')

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must cover behavioral traits. It only lists outputs (price, market cap, etc.) but does not mention error handling, rate limits, data freshness, or permission requirements. This leaves significant gaps for a mutation-free tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, well-structured sentence that is front-loaded and contains no unnecessary words. Every part is relevant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description covers the basic return fields but omits details like real-time vs delayed data, pagination, or error scenarios. It is minimally viable for a simple tool but could be more complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% as the parameter 'token' is documented with examples in the schema. The description adds 'for any cryptocurrency' but does not provide additional constraints or formatting beyond the schema's CoinGecko token ID hint. Baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool gets price, market cap, 24h change, and volume for cryptocurrencies. The verb 'Get' and resource 'cryptocurrency price data' are specific, and it distinguishes from sibling tools like get_gas_fees (gas) and get_fear_greed (sentiment).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description says 'for any cryptocurrency' but does not provide explicit guidance on when to use this tool versus alternatives like get_trending or get_global_market. Context is implied but no explicit when/when-not or sibling comparison.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 10 tool updatesv1.0.0
    • First observedget_defi_tvl
    • First observedget_fear_greed
    • First observedget_gas_fees
    • First observedget_global_market
    • First observedget_lightning_stats
    • First observedget_mempool
    • First observedget_nft_floor
    • First observedget_stablecoins
    • First observedget_token_price
    • First observedget_trending

TDQS

A4/5.0
Disambiguation5/5

Each tool targets a distinct data category (price, gas, sentiment, TVL, mempool, NFT floor, stablecoins, global market, trending, Lightning). No two tools overlap in purpose, making selection unambiguous.

Naming Consistency5/5

All tool names follow a consistent 'get_' prefix followed by a descriptive noun phrase (e.g., get_token_price, get_gas_fees). This pattern is uniform across all 10 tools.

Tool Count5/5

10 tools is an ideal size for a crypto data server. Each tool covers a major data area without being excessive or too sparse.

Completeness4/5

The set covers a broad range of crypto market data: prices, gas, sentiment, DeFi, mempool, NFTs, stablecoins, market overview, trending, and Lightning. Minor gaps like on-chain metrics or exchange rates exist but are not critical.

Maintenance

ActivityMaintained
ResponsivenessNo issues

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

Related MCP Servers

Latest Blog Posts

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/eltociear/tokenguard-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server