SVS API MCP Server

This service is considered to be in beta. Please report any issues

The SVS API MCP is a Model Context Protocol (MCP) server that provides real-time Solana market data. It exposes tools for token prices, metadata, launchpad info, and prediction market candles.

---

Connecting to the Server

The SVS API MCP server is available at:

https://<tier>.api.solanavibestation.com/mcp

Replace <tier> with your subscription tier (e.g. free, basic).

All requests require your API key in the Authorization header. You can subscribe to any free or paid tier at https://cloud.solanavibestation.com to receive an API key.

MCP Client Configuration

Add the following to your MCP client's configuration:

{
  "mcpServers": {
    "svs-api": {
      "type": "http",
      "url": "https://free.api.solanavibestation.com/mcp",
      "headers": {
        "Authorization": "<your-api-key>"
      }
    }
  }
}

Claude Code

You can add the server with a single command:

claude mcp add --transport http -H "Authorization: <your-api-key>" svs-api https://free.api.solanavibestation.com/mcp

Or use the interactive /mcp command inside Claude Code.

Natural language (for telling an agent)

Connect to the SVS API MCP server at https://<tier>.api.solanavibestation.com/mcp using HTTP transport. Include the API key in the Authorization header.

Rate Limits

The MCP server rate limits are included in SVS API rate limits.

---

Example Prompts

These are examples of natural language you can give an agent to use the SVS API tools:

• "What's the current price of SOL in USDC?"

• "Get me the price and 24h volume for token 79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump in USDC."

• "Look up the metadata for this token: 79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump. What's its name, symbol, and description?"

• "Compare the DeFi prices of SOL and USDC side by side."

• "Is 79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump a recently launched token? Get me its launchpad info."

• "Get the 72-hour candle data for this Jupiter prediction market: some-market-id."

• "What's the liquidity and 24h price change for wrapped SOL?"

• "Get the min and max prices over the last hour for these tokens: So11111111111111111111111111111111111111112, EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v."

---

Tools

get_token_price

Get current price and market statistics for one or more Solana tokens. Returns latest price, average/min/max prices, and trading volumes across multiple time windows.

Parameters

Name	Type	Required	Description
mints	string[]	Yes	One or more Solana token mint addresses (max 36).
prices_in_usdc	boolean	No	If true, returns prices in USDC. Default is SOL-denominated.

Response Fields

Field	Description
latest_price	Most recent trade price.
avg_price_1min	Average price over the last 1 minute.
avg_price_15min	Average price over the last 15 minutes.
avg_price_1h	Average price over the last 1 hour.
avg_price_24h	Average price over the last 24 hours.
avg_price_72h	Average price over the last 72 hours.
min_price_* / max_price_*	Min and max prices for each time window.
volume_1min / volume_15min / volume_1h / volume_24h / volume_72h	Trading volume per time window.
base_mint	The token mint address queried.
quote_mint	The quote currency mint (SOL or USDC).
quote_symbol	Symbol of the quote currency.

Example

{
  "mints": ["79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump"],
  "prices_in_usdc": true
}

---

get_defi_price

Get a DeFi-formatted price for a single Solana token. Returns USDC value, 24h price change percentage, native currency price, and liquidity.

Parameters

Name	Type	Required	Description
address	string	Yes	A single Solana token mint address.

Example

{
  "address": "So11111111111111111111111111111111111111112"
}

---

get_defi_multi_price

Get DeFi-formatted prices for multiple Solana tokens in a single call. Returns the same data as get_defi_price for each token.

Parameters

Name	Type	Required	Description
addresses	string[]	Yes	One or more Solana token mint addresses.

Example

{
  "addresses": [
    "So11111111111111111111111111111111111111112",
    "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
  ]
}

---

get_token_metadata

Get on-chain and off-chain metadata for Solana tokens. Returns name, symbol, decimals, URI, creators, and freeze authority.

Parameters

Name	Type	Required	Description
mints	string[]	Yes	One or more Solana token mint addresses (max 36).

Response Fields

Field	Description
name	Token name.
symbol	Token ticker symbol.
decimals	Number of decimal places.
uri	Metadata URI.
primary_creator	Primary creator address.
freeze_authority	Freeze authority address, or null if none.
fungible	Whether the token is fungible.
off_chain_metadata	Object containing off-chain data (description, image, social links, etc.) if available.

Example

{
  "mints": ["79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump"]
}

Example Response

{
  "metas": [
    {
      "name": "Dog saved by Grok",
      "symbol": "LIA",
      "decimals": 6,
      "freeze_authority": null,
      "fungible": false,
      "mint": "79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump",
      "primary_creator": "11111111111111111111111111111111",
      "uri": "https://meta.uxento.io/data/2d5f8505-21e6-4bcf-831a-1342a5210fb1",
      "off_chain_metadata": {
        "name": "Dog saved by Grok",
        "symbol": "LIA",
        "description": "...",
        "image": "https://edge.uxento.io/image/...",
        "twitter": "https://x.com/...",
        "website": "https://..."
      }
    }
  ]
}

---

get_mint_info

Get launchpad token information including creation event, trade history, and off-chain metadata. Supports recent launches (< 72 hours old) from Pump.fun, Raydium, and Meteora DBC.

Parameters

Name	Type	Required	Description
mint	string	Yes	A Solana token mint address for a recent (< 72h) launchpad token.

Example

{
  "mint": "79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump"
}

Note: This tool only works for tokens launched within the last 72 hours on supported launchpads.

---

get_prediction_candles

Get 72-hour OHLCV (Open/High/Low/Close/Volume) candle data for Jupiter prediction markets.

Parameters

Name	Type	Required	Description
market_ids	string[]	Yes	One or more Jupiter prediction market IDs (max 36).

Example

{
  "market_ids": ["some-prediction-market-id"]
}

---

Common Token Addresses

Token	Mint Address
Wrapped SOL	So11111111111111111111111111111111111111112
USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

---

Notes

• All mint addresses are base58-encoded Solana public keys.

• Array parameters accept up to 36 items per request (except where noted).

• Prices default to SOL-denominated unless prices_in_usdc is set to true.

• The get_mint_info tool is limited to tokens launched within the last 72 hours on Pump.fun, Raydium, or Meteora DBC.

• Time windows available for price data: 1min, 15min, 1h, 24h, 72h.