Solana MCP by Vybe README

The full upstream README, mirrored for reference. Install config, tool schemas, adoption signals and our own overview live on the Solana MCP by Vybe listing page.

Solana MCP by Vybe

Solana MCP by Vybe lets Cursor, Claude, Codex, and other MCP clients browse schemas or make live Solana API calls through one public MCP server.

Public Model Context Protocol (MCP) registry metadata for Solana MCP by Vybe.

MCP endpoint

Use the streamable HTTP endpoint:

text
https://mcp.vybenetwork.xyz/mcp

Registry metadata (server.json) publishes the remote as:

text
https://mcp.vybenetwork.xyz

Clients that require an explicit MCP path (ChatGPT Developer Mode, Codex, Cursor HTTP) should use https://mcp.vybenetwork.xyz/mcp.

Copy-paste setup for the public docs site: docs/mcp.md. Live product guides: docs.vybenetwork.com/docs/mcp (still may show the old .com host until that site is updated).

Quick setup

Cursor / Windsurf / Codex-style HTTP

config.json
{
  "mcpServers": {
    "solana-mcp-vybe": {
      "type": "http",
      "url": "https://mcp.vybenetwork.xyz/mcp"
    }
  }
}

Same snippet: examples/cursor-mcp.json.

Claude Desktop via mcp-remote

config.json
{
  "mcpServers": {
    "solana-mcp-vybe": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.vybenetwork.xyz/mcp"]
    }
  }
}

Claude.ai custom connector or Connectors Directory

text
Name: Solana MCP by Vybe
URL:  https://mcp.vybenetwork.xyz/mcp

Portal copy for the official directory: claude-connector-submission.json.

Claude Code / Cowork plugin

This repo is a Claude plugin (/.claude-plugin/plugin.json). Validate, then submit the public GitHub URL:

Terminal
claude plugin validate .

Authenticate with OAuth when the client prompts. Do not commit API keys into this repo.

What this repository holds

  • server.json — metadata published to the official MCP Registry (GitHub Actions). Remote URL: https://mcp.vybenetwork.xyz.
  • .mcp.json and mcp.json — root MCP/plugin configs for directory UIs (e.g. Cursor “Submit a Plugin”). Native HTTP to https://mcp.vybenetwork.xyz/mcp — no secrets.
  • .codex-plugin/plugin.json — Codex plugin metadata for local install/refresh against the same MCP URL.
  • .claude-plugin/plugin.json — Claude Code / Cowork plugin manifest (skills + remote MCP).
  • claude-connector-submission.json — field-by-field copy for the Claude Connectors Directory portal.
  • chatgpt-app-submission.json — draft ChatGPT Apps submission fields.

Available tools

ToolCalls
list-pyth-price-feedsGET /v4/oracle/pyth/pricefeeds
get-pyth-price-candlesGET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/candles
get-pyth-priceGET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/price
get-marketGET /v4/markets/{marketAddress}
list-marketsGET /v4/markets
get-market-candlesGET /v4/markets/{marketAddress}/candles
get-pyth-price-historyGET /v4/oracle/pyth/pricefeeds/{priceFeedAddress}/price-ts
get-pyth-productGET /v4/oracle/pyth/products/{productAddress}
get-token-candlesGET /v4/tokens/{mintAddress}/candles
list-tokensGET /v4/tokens
list-labeled-programsGET /v4/programs/labeled-program-accounts
list-supported-dexesGET /v4/reference/dexes
get-token-liquidityGET /v4/tokens/{mintAddress}/liquidity
get-tokenGET /v4/tokens/{mintAddress}
get-token-holder-count-historyGET /v4/tokens/{mintAddress}/holders-count-ts
list-instruction-namesGET /v4/reference/instruction-names
get-token-trader-activityGET /v4/tokens/{mintAddress}/trader-activity
get-token-top-pnl-tradersGET /v4/tokens/{mintAddress}/top-pnl-traders
get-token-top-holdersGET /v4/tokens/{mintAddress}/top-holders
list-transfersGET /v4/transfers
get-swap-quoteGET /v4/trading/swap-quote
get-token-trade-volume-historyGET /v4/tokens/{mintAddress}/trade-volume-ts
build-swapPOST /v4/trading/swap
list-tradesGET /v4/trades
get-empty-accounts-batchPOST /v4/wallets/batch/empty-accounts
get-dust-accounts-batchPOST /v4/wallets/batch/dust-accounts
get-token-balance-history-batchPOST /v4/wallets/batch/token-balances-ts
get-token-balances-batchPOST /v4/wallets/batch/token-balances
list-top-tradersGET /v4/wallets/top-traders
get-wallet-counterpartiesGET /v4/wallets/{ownerAddress}/counterparties
list-labeled-accountsGET /v4/wallets/labeled-accounts
get-token-accounts-batchPOST /v4/wallets/batch/token-accounts-balance-ts
get-wallet-defi-positionsGET /v4/wallets/{ownerAddress}/defi-positions
get-wallet-empty-accountsGET /v4/wallets/{ownerAddress}/empty-accounts
get-wallet-dust-accountsGET /v4/wallets/{ownerAddress}/dust-accounts
get-wallet-token-account-historyGET /v4/wallets/{ownerAddress}/token-accounts-balance-ts
get-wallet-token-balancesGET /v4/wallets/{ownerAddress}/token-balance
get-wallet-pnlGET /v4/wallets/{ownerAddress}/pnl
get-wallet-pnl-historyGET /v4/wallets/{ownerAddress}/pnl-ts
get-wallet-token-balance-historyGET /v4/wallets/{ownerAddress}/token-balance-ts
build-close-token-accountsPOST /v4/wallets/util/close-token-accounts
get-wallet-transfer-volumeGET /v4/wallets/{ownerAddress}/transfer-volume-usd
build-withdraw-mevPOST /v4/wallets/util/withdraw-mev
get-x402-access-guideStatic x402 pay-per-call guidance. Does not send a payment.

GitHub repository name

vybenetwork/solana-mcp-vybe (starts with solana-mcp, includes Vybe).

Publish a new listing version

  1. Clone or use this repo at github.com/vybenetwork/solana-mcp-vybe

  2. Tag and push (the workflow sets server.json version from the tag):

    bash
    git tag v1.0.0
    git push origin v1.0.0
    

    Or run Actions → Publish to MCP Registry → Run workflow (uses the version already in server.json).

Publishing uses GitHub OIDC in Actions; no personal token secret is required.

If you use mcp-publisher login github locally and get 403 for io.github.vybenetwork/...: Git apps like Git Credential Manager are unrelated. Open GitHub → Settings → Applications → Authorized OAuth Apps, choose the app you authorized during mcp-publisher login github (device flow), then under Organization access click Grant for vybenetwork. On SAML-enforced orgs, also complete SSO for that OAuth app. Then run mcp-publisher logout, mcp-publisher login github, and publish again.

  1. Verify:

    Terminal
    curl -sS "https://registry.modelcontextprotocol.io/v0.1/servers?search=vybenetwork" | jq .
    

Cursor and other directories

Use examples/cursor-mcp.json as the install snippet. For Cursor Directory, submit after the registry publish succeeds; use OAuth for https://mcp.vybenetwork.xyz/mcp.

Registry catalog id

server.json name: io.github.vybenetwork/solana-mcp-vybe. Display title: Solana MCP by Vybe.

Publish: push main, then git tag vX.Y.Z && git push origin vX.Y.Z, or Actions → Publish to MCP Registry.