# 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://<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:

```json
{
  "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:

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

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**

```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**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solanavibestation.com/developers/partner-marketplace/svs-api/svs-api-mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.