Skip to content

Noves-Inc/noves-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Noves MCP Server

An MCP (Model Context Protocol) server that wraps the Noves Intent service to provide natural language blockchain data. This allows AI assistants to have conversational access to blockchain transaction data with human-readable descriptions.

🌟 Features

  • 🗣️ Natural Language Blockchain Data: Get transaction descriptions in plain English
  • 🌐 Multiple Blockchain Support: Works with 100+ blockchain networks supported by Noves
  • 💬 Conversational Interface: Perfect for AI assistants to understand and explain blockchain activity
  • 🔧 Multiple Analysis Tools: 6 specialized tools for different types of blockchain analysis
  • ⚡ Easy Installation: Install via NPM with a single command
  • 🔒 No Authentication Required: Noves Intent service is free to use

🛠️ Available Tools

🔍 Transaction Analysis Tools

  1. get_recent_transactions: Get recent transactions for a wallet address with natural language descriptions
  2. get_transaction_details: Get detailed analysis of a specific transaction (filtered from recent transactions)
  3. get_translated_transaction: Get human-readable description of a specific transaction using Noves translation
  4. get_transaction_transfers: Get detailed transfer information focusing on token movements

📊 Wallet Analysis Tools

  1. get_wallet_summary: Get a comprehensive summary of wallet activity with key insights
  2. analyze_wallet: Analyze wallet activity and provide detailed insights with natural language summaries

💸 Token Price Tools

  1. get_current_token_price: Get the current price of a token on a specific blockchain.
  2. get_historical_token_price: Get the historical price of a token at a specific timestamp.
  3. get_token_price_comparison: Compare a token's price between two timestamps and see the price change.

🚀 Quick Start

Installation for Cursor/Claude

Add this MCP server to your Cursor configuration file (~/.cursor/mcp.json):

{
  "mcpServers": {
    "noves-blockchain-data": {
      "command": "npx",
      "args": ["@noves/[email protected]"]
    }
  }
}

That's it! The server will be automatically downloaded and running when you restart Cursor.

Example Cursor Configuration

{
  "mcpServers": {
    "noves-blockchain-data": {
      "command": "npx",
      "args": ["@noves/[email protected]"]
    }
  }
}

💬 How to Use

Once installed, you can have natural conversations with your AI assistant about blockchain data:

🎯 Example Questions & Conversations

Recent Activity:

"What are the recent transactions for wallet 0x28c6c06298d514db089934071355e5743bf21d60 on Ethereum?"

Wallet Analysis:

"Can you analyze the activity of the Binance hot wallet and tell me what kind of transactions they've been doing?"

Specific Transaction:

"Get details for this transaction hash: 0x1234... and explain what happened"

Token Transfers:

"Show me the recent token transfers for wallet 0xabc123... on Polygon and focus on what tokens were moved"

Comprehensive Summary:

"Give me a complete summary of this wallet's activity on Arbitrum with key insights"

Multi-Chain Analysis:

"Compare the activity of this wallet on Ethereum vs Polygon"

🤖 AI Context Awareness

The AI will automatically choose the best tool based on your question:

  • Asking about "recent activity" → get_recent_transactions
  • Asking about a specific hash → get_translated_transaction
  • Asking for "analysis" or "insights" → analyze_wallet
  • Asking about "transfers" or "tokens moved" → get_transaction_transfers
  • Asking for a "summary" → get_wallet_summary

🌐 Supported Networks

The server supports 100+ blockchain networks that Noves supports, including:

Major Networks Layer 2s Alt Chains
Ethereum (ethereum) Polygon (polygon) Binance Smart Chain (bsc)
Bitcoin (bitcoin) Arbitrum (arbitrum) Avalanche (avalanche)
Optimism (optimism) Fantom (fantom)
Base (base) Cronos (cronos)

And many more! Just use the network name as specified by Noves.

❓ Troubleshooting

MCP Server Shows "0 tools enabled"

  • Make sure you restarted Cursor after adding the configuration
  • Check that the package name and version are correct in your mcp.json
  • Verify your mcp.json syntax is valid JSON

Connection Issues

  • The server uses stdio communication (no network required)
  • No authentication or API keys needed
  • Check Cursor's MCP logs for specific error messages

📄 License

MIT

About

MCP server that wraps Noves Intent service for natural language blockchain data

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published