Stellar Pulse Mcp

io.github.markankamaransheogarat-sysPublished by GitHub account markankamaransheogarat-sysv0.1.0Updated Oct 29, 2026

Read-only Stellar analytics: network and fees, asset checks, SDEX books, accounts, DeFi.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Read-only Stellar analytics MCP server: network fees, asset checks, SDEX order books, account overviews and DeFi TVL from public APIs.

What you can do
  • Check network health: latest ledger stats and current fee levels
  • Look up assets: price, supply, holders, volume, rating, issuer and look-alike warnings
  • Rank the most active assets by volume, trades, payments, holders or rating
  • Inspect SDEX order books: best bid/ask, spread and depth within 1% and 5%
  • Review a public account: balances, spendable XLM, signers, thresholds, flags and recent payments
  • Summarize Stellar DeFi: TVL, chain rank, top protocols and TVL by category
When to use it
Useful when you want an assistant to answer questions about Stellar mainnet — congestion and fees, whether a token is the genuine issuer, book depth and spread, how much XLM an account can actually spend, or which DeFi protocols are growing — without building or signing anything.
Requirements
Runs locally over stdio via npx (npm package stellar-pulse-mcp) and needs Node.js 20 or newer. No API keys, accounts or environment variables; it calls public Horizon, StellarExpert and DefiLlama endpoints, so network access is required. Mainnet only.
Before you install
Read-only: it does not sign or send transactions, and it rejects values starting with S before any network call, so never paste a secret key. Only public addresses starting with G are needed. Asset codes are shared by many issuers, so check the issuer before trusting a token. Figures are cached snapshots of public data and are not financial advice.

Installation

In SourceWeft

  1. Open Stellar Pulse Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

stellar-pulse-mcp

Read-only Stellar analytics for AI assistants, over the Model Context Protocol. Ask Claude (or any MCP client) about network health and fees, asset quality, DEX order books, accounts and DeFi on Stellar, and get structured answers from public APIs. No API keys. No signing. No transactions.

Existing Stellar MCP servers focus on building and sending transactions or developing Soroban contracts. This one is for the other half of the job: understanding what is happening on the network, and spotting what is not trustworthy.

ToolWhat it answers
stellar_network_statusLatest ledger (age, transactions, failure rate, protocol version, base reserve) and fee levels
stellar_assetPrice, supply, holders, 7d volume, rating and look-alike warnings for an asset (XLM, USDC or CODE-ISSUER)
stellar_top_assetsMost active assets by volume, trades, payments, holders or StellarExpert rating
stellar_orderbookSDEX order book for a pair: best bid/ask, mid, spread, depth within 1% and 5%
stellar_accountBalances, spendable XLM after reserve and open offers, signers, thresholds, clawback flag, recent payments
stellar_defiStellar DeFi from DefiLlama: TVL, rank among chains, leading protocols, TVL by category

Example prompts:

  • "Is the Stellar network congested right now, and what are fees doing?"
  • "Is this USDC the real one?" (give it USDC-G...; it checks the issuer, domain, holders and rating)
  • "How deep is the XLM/USDC book on the SDEX, and what is the spread?"
  • "How much XLM can this account actually spend?"
  • "What are the biggest DeFi protocols on Stellar and which are growing?"

Why the safety details matter

  • Many assets share a code. Anyone can issue a token called USDC. stellar_asset picks the most traded one when you give only a code, tells you how many others use the same code, and flags issuers with no verified home domain, a low rating, very few holders or no volume.
  • Secret keys are refused. A value starting with S is rejected immediately, before any network call, and never echoed back. Public addresses (starting with G) are all this server ever needs.
  • Spendable XLM is computed, not guessed: (2 + subentries + sponsoring - sponsored) x base reserve, minus XLM locked in open offers, with the reserve read from the latest ledger.

Install

Requires Node.js 20 or newer. The quickest way is npx, no clone needed:

Claude Code

bash
claude mcp add stellar-pulse -- npx -y stellar-pulse-mcp

On Windows, run it from cmd (PowerShell swallows the --) and wrap npx so Claude Code can start it:

bat
claude mcp add stellar-pulse -- cmd /c npx -y stellar-pulse-mcp

Add -s user to make it available in every folder, not just the current project.

Claude Desktop

json
{  "mcpServers": {    "stellar-pulse": {      "command": "npx",      "args": ["-y", "stellar-pulse-mcp"]    }  }}

On Windows use "command": "cmd" with "args": ["/c", "npx", "-y", "stellar-pulse-mcp"].

Published on npm and in the official MCP Registry as io.github.markankamaransheogarat-sys/stellar-pulse-mcp.

To run it from source instead:

bash
git clone https://github.com/markankamaransheogarat-sys/stellar-pulse-mcp.gitcd stellar-pulse-mcpnpm installnpm run buildnode dist/index.js

Details

  • Data sources: Horizon (ledgers, fees, accounts, order books), StellarExpert (asset statistics and ratings) and DefiLlama (TVL). Mainnet only.
  • Units: Horizon amounts are decimal units; StellarExpert supplies and volumes come in stroops and are converted (1 XLM = 10,000,000 stroops).
  • One source down is not a failure. Where a tool combines sources, it answers from what is reachable and lists what failed in an errors field.
  • Caching: 3 to 4 seconds for ledger-level data, 60 seconds for StellarExpert, 5 minutes for DefiLlama, so free tiers are not hammered. Simultaneous identical requests share one call.
  • Depth counts the best 100 levels per side of the SDEX book. Liquidity pools and Soroban DEXes are not included.
  • Not financial advice. Snapshots of public data, seconds to minutes old.

Development

bash
npm run typecheck   # tsc --noEmit over src and testsnpm test            # vitest, all HTTP mockednpm run build       # compile to dist/npm run smoke       # live check against the real APIs (needs a build first)

src/sources/* talk to one API each, src/tools/* hold the logic and register one MCP tool each, src/stellar.ts validates account ids and asset references, src/http.ts is the shared client (timeout, bounded retries, TTL cache).

A sibling project, crypto-pulse-mcp, does the same for cross-exchange prices, perpetual funding and stablecoin flows.

License

MIT

Source: README.md at commit dd88fb7

Tools

6

stellar_network_status

Stellar network health and fees

Latest Stellar ledger (sequence, age, transactions, failure rate, protocol version, base reserve) and current fee levels (base fee, charged fee percentiles, capacity use, surge pricing).

Takes no parameters.

stellar_asset

Stellar asset profile

Price, supply, holders, 7-day volume, StellarExpert rating and verification flags for a Stellar asset. Accepts XLM, a code like USDC (picks the most traded one and lists look-alikes) or an exact CODE-ISSUER. Use it to check an issuer before trusting a token.

Parametersassetrequired

stellar_top_assets

Top Stellar assets

The most active Stellar assets ranked by 7-day volume, trades, payments, holders or StellarExpert rating.

Parameterslimitsort_by

stellar_orderbook

SDEX order book

Order book of a pair on the Stellar DEX: best bid/ask, mid price, spread and resting depth within 1% and 5%, plus the top levels. Assets can be XLM, a code like USDC (most traded issuer is used and disclosed) or CODE-ISSUER.

Parametersbaserequiredlevelscounterrequired

stellar_account

Stellar account overview

Public overview of a Stellar account: balances, spendable XLM after the reserve and open-offer liabilities, signers and thresholds, flags such as clawback, and the latest payments. Takes a public address starting with G.

Parametersaccountrequiredpayments_limit

stellar_defi

Stellar DeFi overview

DeFi on Stellar from DefiLlama: total value locked, rank among all chains, the leading protocols with 1d/7d change, and TVL by category (lending, DEX, yield...).

Parameterslimit

Version history

1
  1. v0.1.0LatestOct 22, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts