Skip to content

Synternet/synternet-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Python Version Status

Features

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

Tools

Tool Name Description Parameters
get_synt_price Get information about SYNT token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_btc_price Get information about Bitcoin (price, volume, 24h volume and price change, 30d price change, market cap) None
get_eth_price Get information about Ethereum (price, volume, 24h volume and price change, 30d price change, market cap) None
get_osmo_price Get information about Osmosis token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_akt_price Get information about Akash token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_atom_price Get information about Atom token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_pica_price Get information about Pica token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_tia_price Get information about Celestia token (price, volume, 24h volume and price change, 30d price change, market cap) None
get_usdc_price Get information about USDC (price, volume, 24h volume and price change, 30d price change, market cap) None
get_usdt_price Get information about USDT (price, volume, 24h volume and price change, 30d price change, market cap) None
get_inj_price Get information about Injective token (price, volume, 24h volume and price change, 30d price change, market cap) None

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

Metric Value
Current Price $109,028.74
24h Trading Volume $225,577,575.44
Market Capitalization $14.06 Billion

Performance Analysis

24-Hour Changes

Period Price Change Volume Change
24 Hours -0.68% ↓ +2.32% ↑
30 Days +15.97% ↑ -

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

Cryptocurrency Current Price (USD) 24h Trading Volume 24h Volume Change 24h Price Change 30d Price Change Market Cap
BTC (Bitcoin) $101,882.00 $310,245,403.53 -16.42% -1.57% +19.17% $13.14B
ETH (Ethereum) $2,536.43 $24,082,102,394.54 -34.28% -4.33% +54.18% $306.22B
SYNT (Synternet) $0.0201 $1,864,612.68 -10.19% -3.73% +33.64% $13.20M
AKT (Akash) $1.61 $13,405,209.03 -17.83% -9.39% +45.01% $399.41M
PICA (Picasso) $0.000072 $41,450.48 -16.80% +4.01% +54.03% N/A
TIA (Celestia) $2.81 $118,305,820.68 -23.51% -13.38% +10.47% $1.79B
USDC $1.00 $10,752,067,123.47 -14.46% +0.01% +0.01% $60.51B
USDT (Tether) $1.00 $81,784,372,585.34 -21.83% +0.03% +0.04% $150.71B
INJ (Injective) $12.41 $126,724,215.75 -12.07% -9.11% +55.63% $1.24B

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 LICENSE file for details.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages