# SVS API MCP Server {% hint style="info" %} This service is considered to be in beta. Please report any issues {% endhint %} 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://.api.solanavibestation.com/mcp ``` Replace `` 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 to receive an API key. ### MCP Client Configuration Add the following to your MCP client's configuration: ```json { "mcpServers": { "svs-api": { "type": "http", "url": "https://free.api.solanavibestation.com/mcp", "headers": { "Authorization": "" } } } } ``` ### Claude Code You can add the server with a single command: ```bash claude mcp add svs-api https://.api.solanavibestation.com/mcp --transport http -H "Authorization: " ``` Or use the interactive `/mcp` command inside Claude Code. ### Natural language (for telling an agent) > Connect to the SVS API MCP server at `https://.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** ```json { "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** ```json { "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** ```json { "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** ```json { "mints": ["79dGFnR8XUusyDiK3n8yZ6FXhJjWLFgzdsi2SkUpump"] } ``` **Example Response** ```json { "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** ```json { "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** ```json { "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**.