FinanceOS MCP
FinanceOS MCP gives Claude real-time access to crypto and stock market data, portfolio analysis, and market sentiment tools — no API keys required.
Live Crypto Prices — Fetch real-time price, 24h/7d change, market cap, volume, and ATH for 10,000+ coins via CoinGecko; supports multiple coins in a single request using comma-separated IDs
Stock Quotes — Real-time quotes for US stocks (e.g. AAPL, TSLA) and Indian NSE/BSE stocks (e.g. RELIANCE.NS) via Yahoo Finance
Portfolio P&L — Calculate real-time profit/loss across a mixed crypto/stock portfolio, with per-asset breakdown and total performance
Fear & Greed Index — Crypto Fear & Greed Index (0–100) with 7-day history and investment sentiment interpretation
Top Market Movers — Top gaining and losing cryptocurrencies in the last 24h from the top 100 by market cap (configurable limit)
Bittensor (TAO) Stats — Live TAO price, network statistics, and staking/passive income yield details
Global Crypto Market Overview — Total market cap, Bitcoin dominance, 24h trading volume, and active coin count
Provides real-time price data, market analysis, and portfolio tracking for Bitcoin through crypto price lookup and portfolio management tools.
Provides real-time price data, market analysis, and portfolio tracking for Ethereum through crypto price lookup and portfolio management tools.
Provides real-time price data, market analysis, and portfolio tracking for Solana through crypto price lookup and portfolio management tools.
💰 FinanceOS MCP...
FinanceOS MCP 💰
Real-time finance & crypto superpowers for Claude. Built for investors, by an investor.
Give Claude live access to crypto prices, stock quotes, portfolio P&L, risk analysis, Bittensor stats, and market sentiment — all in natural language.
🛠️ Tools Included
Tool | What it does |
| Live price, 24h/7d change, market cap for any crypto |
| Real-time P&L across your crypto holdings |
| NSE, BSE & global stock prices (Yahoo Finance) |
| Crypto market sentiment (0–100 scale) |
| TAO price, network data, staking APY overview |
| Top gainers & losers in the last 24h |
| Diversification score, concentration risk, suggestions |
Related MCP server: Market Pulse MCP
⚡ Quick Setup (5 minutes)
Step 1 — Install
git clone https://github.com/YOUR_USERNAME/financeos-mcp
cd financeos-mcp
npm install
npm run buildStep 2 — Add to Claude Desktop
Open your Claude Desktop config file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add this (replace the path with your actual path):
{
"mcpServers": {
"financeos": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/financeos-mcp/build/index.js"]
}
}
}Step 3 — Restart Claude Desktop
Quit and reopen Claude Desktop. You should see a 🔨 hammer icon in the chat box. Click it — you'll see all 7 FinanceOS tools listed.
Step 4 — Try it out
Ask Claude any of these:
"What's the current Bitcoin price and sentiment?"
"Analyse my portfolio: bitcoin:0.5, ethereum:2, solana:10"
"How is RELIANCE.NS doing today?"
"Show me top 5 crypto gainers right now"
"Give me a full Bittensor overview"
💬 Example Prompts
"How is my portfolio doing? I hold 0.5 BTC, 2 ETH, and 15 SOL.
I bought BTC at $45000, ETH at $2000, SOL at $120."
"What's the market sentiment today? Should I be buying or waiting?"
"Analyse the risk of this portfolio:
bitcoin:20000, ethereum:8000, INFY.NS:5000, gold:3000, reliance:4000"
"Give me a complete Bittensor briefing — price, network, staking."🔧 Test Without Claude
Use the MCP Inspector to test all tools in a browser UI:
npx @modelcontextprotocol/inspector node build/index.jsOpen the URL shown → Connect → click any tool → Run.
🚀 Pro Version
Want FinanceOS without any installation? No Node.js, no config files, ready in 60 seconds.
FinanceOS MCP Pro — $19/month →
✅ No installation required
✅ Higher rate limits
✅ 1 week free trial
✅ Priority support
✅ Early access to v2 tools (coming soon)
Free version always available here on GitHub.
🗺️ Roadmap
Dividend calendar for stocks
DeFi yield tracker (Aave, Compound)
Indian mutual fund NAV lookup
REIT yield comparator
P2P lending portfolio tracker
Bittensor subnet miner rankings
📋 Data Sources
All free, no API keys required:
CoinGecko — crypto prices
Yahoo Finance — stock quotes
Alternative.me — fear & greed index
📄 License
MIT — free to use, modify, and sell integrations.
Built with ❤️ using the Model Context Protocol SDK
Available Tools
8 toolsget_bittensor_statsA
Get live Bittensor (TAO) price, network stats and a breakdown of passive income options including staking yield.
| 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 full burden of behavioral disclosure. It mentions 'live' data, implying real-time or current information, but fails to specify data sources, update frequency, rate limits, authentication needs, or error handling. For a tool with zero annotation coverage, this leaves significant gaps in understanding its 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 a single, efficient sentence that front-loads the core purpose ('Get live Bittensor (TAO) price, network stats') and adds relevant details ('breakdown of passive income options including staking yield') without any wasted words. Every part of the sentence contributes to understanding the tool's function.
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 complexity (simple data retrieval with 0 parameters) and lack of annotations/output schema, the description is minimally complete—it states what data is returned but omits behavioral details like data freshness, sources, or format. It's adequate for basic use but leaves operational questions unanswered, fitting a score of 3 as the minimum viable.
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 0 parameters with 100% schema description coverage, so the schema fully documents the lack of inputs. The description adds no parameter-specific information, which is acceptable since no parameters exist. A baseline of 4 is appropriate as the description doesn't need to compensate for any parameter gaps.
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 purpose with specific verbs ('Get live Bittensor (TAO) price, network stats') and resources ('Bittensor (TAO)', 'passive income options'), distinguishing it from siblings like get_crypto_price (general crypto) or get_stock_quote (stocks). It explicitly identifies the target cryptocurrency and the types of data returned.
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 context by specifying 'Bittensor (TAO)' and 'passive income options including staking yield', which guides when to use this tool (for TAO-specific data with income insights) versus siblings like get_crypto_price (general prices) or get_global_crypto_market (broad market data). However, it lacks explicit exclusions or named alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_crypto_priceA
Get live crypto price, 24h/7d change, market cap, volume and ATH. Supports Bitcoin, Ethereum, TAO (Bittensor) and 10,000+ coins via CoinGecko ID.
| Name | Required | Description | Default |
|---|---|---|---|
| coin_id | Yes | CoinGecko coin ID e.g. bitcoin, ethereum, bittensor, solana | |
| currency | No | Display currency. Default: usd | usd |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses key behavioral traits: it fetches live data, supports a wide range of coins, and uses CoinGecko as the source. However, it does not mention rate limits, error handling, or authentication needs, leaving gaps in operational context for a tool that likely queries an external API.
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 front-loaded with the core purpose and efficiently lists the returned metrics and supported coins in a single, dense sentence. Every element (e.g., data points, coin examples, source) serves to clarify usage without redundancy, making it highly concise and well-structured.
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 moderate complexity (2 parameters, no output schema, no annotations), the description is adequate but incomplete. It covers what the tool does and the data returned, but lacks details on output format, error cases, or performance constraints, which are important for an API-based tool without structured output documentation.
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 both parameters (coin_id and currency) thoroughly. The description adds marginal value by reinforcing the CoinGecko ID usage and listing example coins, but does not provide additional syntax or format details beyond what the schema specifies, aligning with the baseline for high 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 clearly states the specific action ('Get live crypto price') and resources ('Bitcoin, Ethereum, TAO (Bittensor) and 10,000+ coins'), distinguishing it from siblings like get_bittensor_stats (specific to Bittensor) or get_stock_quote (stocks). It explicitly lists the data returned (price, 24h/7d change, market cap, volume, ATH), making the purpose highly specific and differentiated.
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 data source ('via CoinGecko ID') and supported coins, which helps guide usage. However, it does not explicitly state when to use alternatives like get_multiple_crypto_prices (for multiple coins) or get_top_movers (for trending data), so it lacks explicit exclusions or comparisons to siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_fear_greed_indexA
Get the Crypto Fear & Greed Index (0=Extreme Fear, 100=Extreme Greed) with 7-day history and investment interpretation.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It discloses the 0-100 scale interpretation and historical data scope, but doesn't mention rate limits, data freshness, source reliability, or error conditions. The behavioral disclosure is adequate but lacks operational details.
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?
Single sentence efficiently conveys purpose, scale interpretation, data scope, and use context. Every element earns its place with zero redundant information. The structure is front-loaded with the core function.
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 zero-parameter tool with no annotations and no output schema, the description provides good context about what data is returned (current index, 7-day history, interpretation). However, it doesn't specify the exact return format (e.g., JSON structure) or whether the interpretation is textual or categorical.
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 has 0 parameters with 100% coverage, so no parameter documentation is needed. The description appropriately focuses on what the tool returns rather than inputs. A baseline of 4 is appropriate for zero-parameter tools.
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 specific action ('Get'), resource ('Crypto Fear & Greed Index'), and scope ('with 7-day history and investment interpretation'). It distinguishes from sibling tools like get_crypto_price or get_global_crypto_market by focusing on this specific sentiment index rather than price or market data.
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 context by mentioning 'investment interpretation' and the 0-100 scale with emotional extremes, suggesting this tool is for market sentiment analysis. However, it doesn't explicitly state when to use this versus alternatives like get_top_movers for volatility or get_global_crypto_market for broader metrics.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_global_crypto_marketA
Get global crypto market overview: total market cap, BTC dominance, 24h volume and active coin count.
| 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 full burden of behavioral disclosure. It describes what data is returned but does not mention critical behavioral traits such as data sources, update frequency, rate limits, authentication needs, or error handling. For a data-fetching tool with zero annotation coverage, 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, efficient sentence that front-loads the purpose ('Get global crypto market overview') and lists key metrics without unnecessary words. Every element earns its place, making it highly concise and well-structured for quick understanding.
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 (0 parameters, no output schema, no annotations), the description is adequate but incomplete. It covers the purpose and output metrics but lacks behavioral context (e.g., data freshness, limitations). For a straightforward read-only tool, it meets minimum viability but could benefit from additional operational 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 has 0 parameters with 100% coverage, so no parameter documentation is needed. The description appropriately focuses on the tool's purpose and output metrics, adding value by specifying what data is retrieved without redundant parameter details. Baseline is 4 for zero-parameter tools.
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 specific action ('Get') and resource ('global crypto market overview'), listing the exact metrics returned: total market cap, BTC dominance, 24h volume, and active coin count. It distinguishes this tool from siblings like get_crypto_price (single price) or get_top_movers (movement-focused) by emphasizing a comprehensive market overview.
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 obtaining a broad market snapshot, but does not explicitly state when to use this tool versus alternatives like get_fear_greed_index (sentiment) or get_portfolio_summary (personal holdings). It provides context but lacks explicit guidance on exclusions or comparisons to sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_multiple_crypto_pricesB
Get live prices for multiple cryptocurrencies at once. Perfect for a portfolio snapshot.
| Name | Required | Description | Default |
|---|---|---|---|
| coin_ids | Yes | Comma-separated CoinGecko IDs e.g. bitcoin,ethereum,bittensor | |
| currency | No | Display currency. Default: usd | usd |
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 mentions 'live prices' and 'at once', hinting at real-time data and batch processing, but lacks critical details like rate limits, data freshness, error handling, or response format. For a tool fetching financial data, this is a significant gap in transparency.
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 highly concise with two sentences that directly convey the core functionality and a key use case. Every word earns its place, and it's front-loaded with the primary purpose. No wasted verbiage 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?
Given the tool's moderate complexity (batch price fetching), lack of annotations, and no output schema, the description is minimally adequate but incomplete. It covers the 'what' but misses behavioral details (e.g., rate limits, data sources) and output expectations. With 100% schema coverage, it meets a basic threshold but doesn't fully compensate for the missing structured data.
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 fully documents both parameters (coin_ids and currency). The description adds no additional parameter semantics beyond what's in the schema, such as examples of valid coin IDs beyond the schema's 'bitcoin,ethereum,bittensor' or clarification on currency support. Baseline 3 is appropriate when the schema does all the work.
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 purpose with a specific verb ('Get') and resource ('live prices for multiple cryptocurrencies'), distinguishing it from single-crypto tools like 'get_crypto_price'. However, it doesn't explicitly differentiate from portfolio-related siblings like 'get_portfolio_summary' beyond the 'portfolio snapshot' hint.
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 context with 'Perfect for a portfolio snapshot', suggesting when this tool might be preferred. However, it doesn't provide explicit guidance on when to use this versus alternatives like 'get_crypto_price' (single coin) or 'get_portfolio_summary' (broader portfolio data), nor does it mention any exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_portfolio_summaryB
Calculate real-time P&L for a portfolio of crypto and/or stocks. Returns per-asset breakdown and total portfolio performance.
| Name | Required | Description | Default |
|---|---|---|---|
| holdings | Yes | List of holdings with asset ID, quantity and average buy price. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions 'real-time P&L' calculation and return format ('per-asset breakdown and total portfolio performance'), but doesn't specify data sources, update frequency, accuracy limitations, or error handling. For a financial calculation tool with no annotation coverage, this leaves significant behavioral aspects undocumented.
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 perfectly concise with two sentences that each earn their place. The first sentence states the core functionality, and the second specifies the return format. No wasted words, and the information is front-loaded with the primary purpose stated immediately.
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 calculation tool with no annotations and no output schema, the description provides adequate basic information but leaves gaps. It covers what the tool does and what it returns at a high level, but doesn't address important contextual details like calculation methodology, data freshness, error conditions, or performance characteristics that would be important for an AI agent to use this tool effectively.
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%, providing complete parameter documentation. The description adds minimal value beyond the schema - it mentions 'portfolio of crypto and/or stocks' which aligns with the asset parameter descriptions, but doesn't provide additional context about parameter usage, validation rules, or edge cases. Baseline 3 is appropriate when schema does the heavy lifting.
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 purpose: 'Calculate real-time P&L for a portfolio of crypto and/or stocks.' It specifies the verb (calculate) and resource (portfolio P&L), and distinguishes from siblings by focusing on portfolio-level analysis rather than individual asset data. However, it doesn't explicitly contrast with all sibling tools like get_top_movers which might also involve portfolio-related metrics.
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 context ('for a portfolio of crypto and/or stocks') but doesn't provide explicit guidance on when to use this tool versus alternatives. For example, it doesn't clarify if this should be used instead of get_multiple_crypto_prices for portfolio calculations or how it differs from get_top_movers in portfolio analysis scenarios. The context is clear but lacks specific when/when-not instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_stock_quoteC
Get a real-time stock quote. US stocks: AAPL, TSLA. Indian NSE stocks: RELIANCE.NS, TCS.NS, INFY.NS
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Stock ticker e.g. AAPL, RELIANCE.NS |
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 states the tool provides 'real-time' quotes, which is useful context, but doesn't cover other important aspects like rate limits, data sources, error handling, or what the output looks like (e.g., price, volume, timestamp). For a tool with zero annotation coverage, this leaves significant gaps in understanding its 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 extremely concise and front-loaded, with every sentence earning its place. The first sentence states the core purpose, and the second provides essential examples without unnecessary details. There's zero waste, making it easy to parse quickly.
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 financial data tools, no annotations, and no output schema, the description is incomplete. It lacks information on return values (e.g., what fields are included in the quote), error cases, authentication needs, or performance characteristics. While concise, it doesn't provide enough context for reliable use without additional assumptions.
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 has 100% description coverage, with the 'symbol' parameter clearly documented. The description adds value by providing concrete examples (e.g., 'AAPL', 'RELIANCE.NS') and clarifying regional distinctions (US vs. Indian NSE stocks), which helps users understand valid inputs beyond the schema's generic description. However, it doesn't explain parameter constraints or formats in depth.
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 purpose with a specific verb ('Get') and resource ('real-time stock quote'), making it immediately understandable. However, it doesn't explicitly distinguish this tool from its siblings (like 'get_crypto_price' or 'get_top_movers'), which would require mentioning it's specifically for stocks rather than other asset classes.
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. It lists example symbols but doesn't explain why to choose this over sibling tools like 'get_crypto_price' for cryptocurrencies or 'get_top_movers' for market trends. There's no mention of prerequisites, limitations, or comparative context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_top_moversB
Get top gaining and losing cryptocurrencies in the last 24h from the top 100 by market cap.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many gainers/losers to show. Default: 5 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It describes what data is retrieved but lacks details on behavioral traits such as rate limits, authentication needs, data freshness, or error handling. For a data-fetching tool with zero annotation coverage, this is a significant gap in transparency.
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 that front-loads the core functionality without unnecessary details. Every word contributes to understanding the tool's purpose, making it appropriately sized and well-structured for quick comprehension.
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 low complexity (one optional parameter, no output schema), the description is minimally complete. It covers the what and scope but lacks context on behavioral aspects like performance or data sources. Without annotations or an output schema, more detail on return values or usage constraints would improve completeness for this data retrieval tool.
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 has 100% description coverage, with the 'limit' parameter fully documented in the schema. The description adds no parameter-specific information beyond what the schema provides, such as constraints on the limit value or how gainers/losers are ranked. With high schema coverage, the baseline score of 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's purpose: 'Get top gaining and losing cryptocurrencies in the last 24h from the top 100 by market cap.' It specifies the verb ('Get'), resource ('cryptocurrencies'), timeframe ('last 24h'), and scope ('top 100 by market cap'). However, it doesn't explicitly differentiate from siblings like 'get_global_crypto_market' or 'get_crypto_price', which could provide overlapping market data.
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 context by specifying 'top gaining and losing' and 'last 24h', suggesting it's for tracking short-term market movements. However, it provides no explicit guidance on when to use this tool versus alternatives like 'get_global_crypto_market' for broader metrics or 'get_crypto_price' for specific assets. The usage is clear but lacks comparative guidance.
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.
8 tool updates
v1.0.0- First observed
get_bittensor_stats - First observed
get_crypto_price - First observed
get_fear_greed_index - First observed
get_global_crypto_market - First observed
get_multiple_crypto_prices - First observed
get_portfolio_summary - First observed
get_stock_quote - First observed
get_top_movers
TDQS
Most tools have distinct purposes, but there is some overlap between get_crypto_price and get_multiple_crypto_prices, which could cause confusion about when to use each. The other tools target specific, non-overlapping functions like market indices, portfolio analysis, and stock quotes.
All tool names follow a consistent get_* pattern, using snake_case throughout. This predictability makes it easy for an agent to understand and navigate the tool set without confusion.
With 8 tools, the count is well-scoped for a finance-focused server, covering key areas like crypto prices, market data, portfolio tracking, and stock quotes. Each tool serves a clear purpose without feeling excessive or insufficient.
The tool set provides strong coverage for crypto and stock data retrieval, but lacks update or action-oriented tools (e.g., trade execution, portfolio rebalancing). This is a minor gap, as agents can still perform core monitoring and analysis tasks effectively.
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
Global stock research, ML forecasts, valuation signals, screeners & portfolio tracking in Claude
90+ free tools, Claude & ChatGPT: prices, options, SEC filings, 13F, insider, congress, transcripts.
Connect your portfolio to Claude, ChatGPT, or Codex to analyze it and make smarter investments.
Live crypto prices, conversion, gas tracker, portfolio tools, and calculators for AI agents.
101
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides AI agents with real-time financial market intelligence including stock quotes, crypto data, technical analysis, and portfolio insights. Enables natural language queries for current prices, technical indicators, asset comparisons, and portfolio analysis.176MIT
- AlicenseAqualityFmaintenanceEnables Claude to access real-time crypto prices, forex rates, and market sentiment data through free public APIs with no keys required.53MIT
- AlicenseAqualityDmaintenanceProvides real-time stock quotes, market indices, historical data, and financial visualizations from Yahoo Finance without API keys, enabling users to analyze and visualize market data through Claude.3191MIT
- AlicenseBqualityAmaintenanceProvides 32 trading analysis tools for AI-powered market analysis, including real-time data, technical indicators, options Greeks, scanners, and Interactive Brokers portfolio management, all accessible via natural language in Claude Desktop.35350MIT
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/arjunsena-git/financeos-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server