Synternet/synternet-mcp-server

What is Synternet?

Synternet is building the open marketplace for real-time, indexed, AI-ready data - fueling intelligent agents that transform how DeFi participants monitor, secure, and act on cross-chain activity. From proof-of-reserves to depeg detection, we're solving the most urgent data challenges in decentralized finance. By enabling modular, plug-and-play agents like Synternet Insights and Syntoshi, we empower traders, protocols, and treasuries to operate with speed, precision, and foresight across any network.

Synternet MCP Server

An MCP server that delivers real-time, indexed, AI-ready data to AI agents.

Features

• Crypto Analysis: Retrieve information about specific tokens
• Wallet Tracking: Get information about any crypto wallet

Tools

Prerequisites

• Python: 3.10 or higher
• SYNT token: At least 10 SYNT tokens
• Synternet account and access token: Obtain an access token from the Synternet Developer Portal

Installation

1. Clone the Repository:

   git clone https://github.com/Synternet/synternet-mcp-server.git
   

2. Configure Client:

   {
     "mcpServers": {
       "crypto-sentiment-mcp": {
         "command": "uv",
         "args": ["--directory", "/full_path/to/synternet-mcp", "run", "synternet.py"],
         "env": {
           "SYNTERNET_ACCESS_TOKEN": "your_api_key_here"
         }
       }
     }
   }
   

Examples

Below are examples of natural language inputs and their corresponding outputs when interacting with the server via an MCP-compatible client:

Example 1: Bitcoin Price Query

Input: "What is BTC price and volume today, how has it changed over 24h?"

Output:

Bitcoin (BTC) Price & Volume Report

Report Date: January 28, 2025
Data Source: Live API via Claude AI Assistant
Last Updated: 1748330760 (Unix Timestamp)

---

Current Market Data

Performance Analysis

24-Hour Changes

Key Insights

Price Movement

• Bitcoin experienced a slight decline of 0.68% over the past 24 hours
• Current price sits at $109,028.74, maintaining above the $109K level
• Strong monthly performance with +15.97% growth over 30 days

Trading Activity

• Trading volume increased by 2.32% in the last 24 hours
• Daily volume of $225.58 million indicates continued market interest
• Volume increase despite price decline suggests active trading and potential accumulation

Market Context

Price Level Analysis

• Resistance Level: Bitcoin holding above $109,000
• Monthly Trend: Strong upward momentum (+15.97%)
• Short-term: Minor consolidation with slight pullback

Volume Analysis

• Positive Volume Trend: +2.32% increase suggests healthy market activity
• Trading Interest: Sustained volume despite price decline
• Market Sentiment: Active participation from traders and investors

Technical Summary

Bitcoin is currently experiencing a minor correction of -0.68% while maintaining strong monthly gains of nearly 16%. The increase in trading volume (+2.32%) during this price decline is a positive indicator, suggesting that the market remains active and engaged at current price levels.

The combination of:

• Strong monthly performance (+15.97%)
• Stable price above $109K
• Increasing trading volume (+2.32%)

indicates a healthy consolidation phase rather than a significant market downturn.

---

Data Attribution

API Function Used: get_btc_price()
Data Provider: Real-time cryptocurrency market data
Report Generated: January 28, 2025
Generated By: Claude AI Assistant

Example 2: Market Overview

Input: "Provide crypto market report for today"

Output:

Cryptocurrency Price Report

Date: May 15, 2025
Source: Live API Data via Claude AI Assistant
Last Updated: 1747295220 (Unix Timestamp)

All Available Cryptocurrencies

Key Market Observations

Short-term Performance (24h)

• Largest Decline: TIA (Celestia) with -13.38%
• Only Positive Performer: PICA (Picasso) with +4.01%
• Most Stable: Stablecoins USDC and USDT maintaining dollar peg

Monthly Performance (30d)

• Best Performer: INJ (Injective) with +55.63%
• Second Best: ETH (Ethereum) with +54.18%
• Lowest Growth: TIA (Celestia) with +10.47%

Trading Volume Trends

• Highest Volume: USDT with $81.78B (24h)
• Second Highest: ETH with $24.08B (24h)
• Lowest Volume: PICA with $41,450 (24h)
• Volume Decline: All assets showing negative 24h volume changes

Market Capitalization

• Largest: USDT at $150.71B
• Second Largest: ETH at $306.22B
• Smallest: SYNT at $13.20M

Technical Notes

• Data retrieved via real-time API functions
• All prices in USD
• Market cap dominance percentages available for select cryptocurrencies
• Some API functions (OSMO, ATOM) returned errors during data collection
• PICA market cap data not available (N/A)

Disclaimer

This data is provided for informational purposes only and should not be considered financial advice. Cryptocurrency prices are highly volatile and can change rapidly. Always conduct your own research before making investment decisions.

---

Generated by: Claude AI Assistant
API Functions Used:

• get_btc_price()
• get_eth_price()
• get_synt_price()
• get_akt_price()
• get_pica_price()
• get_tia_price()
• get_usdc_price()
• get_usdt_price()
• get_inj_price()

License

This project is licensed under the MIT License - see the file for details.