# Crypto Data MCP Server (`gochujang/crypto-market-data-mcp`) Actor

Crypto data MCP server: real-time market data API for AI agents. Tools include kimchi premium, DeFi yields, ETF flows, Fear & Greed index, funding rates, and market metrics. No API keys required. Persistent HTTP server.

- **URL**: https://apify.com/gochujang/crypto-market-data-mcp.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Business, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### What does Crypto Data MCP Server do?

**Crypto Data MCP Server** is a persistent **crypto data MCP server** built on Apify Standby, designed to feed live market intelligence directly into AI agents via the **Model Context Protocol**. Instead of one-shot scraping, it runs as a long-lived HTTP server that your AI assistant queries on demand — delivering real-time kimchi premium, DeFi yields, ETF flows, Fear & Greed index, funding rates, and market overview **without any API keys or setup**. As a native **Model Context Protocol crypto** integration on Apify, it stays warm and responds in milliseconds, making it the easiest path to plug live crypto context into Claude Desktop, GPT, or any MCP-compatible agent.

> **Important:** This is a **server actor**, not a one-shot scraper. Do NOT click "Run" — use the **Standby URL** to connect your AI agent. Clicking "Run" starts a short-lived instance that will time out.

***

### Why use Crypto Data MCP Server?

**AI crypto data integration** has never been simpler — no credential management, no infrastructure, no polling loops.

- **AI trading agents** — inject live funding rates, ETF flows, and Fear & Greed scores into automated strategy signals without managing API keys yourself
- **Claude Desktop / ChatGPT plugins** — ask "what's BTC fear & greed today?" and get a live answer in chat, powered by this MCP server
- **Crypto research pipelines** — pull structured market data on demand into notebooks, dashboards, or LLM chains
- **Crypto chatbots** — add live DeFi yield data and kimchi premium to any LLM application without backend work
- **Quantitative analysts** — fetch funding rate spreads across CEXs and ETF flow signals as clean JSON, ready for downstream processing

***

### How to use Crypto Data MCP Server

1. Open the actor page and click the **Integrations** tab
2. Copy your personal **Standby URL** (format: `https://xxxxxxxxxxxxxxxx.apify.actor`)
3. Add the server to your Claude Desktop config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "crypto-data": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR_STANDBY_URL/mcp/v1"]
    }
  }
}
```

4. Restart Claude Desktop — the 6 crypto tools appear automatically in the tools panel
5. Ask Claude anything: "What are the top DeFi yields above 10% APY?" — it calls the MCP server live

***

### Input

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `port` | integer | `8080` | Internal port for the MCP server (no change needed for most users) |

***

### Output

The MCP server returns structured JSON per tool call. Example responses:

```json
{
  "tool": "get_fear_greed",
  "value": 62,
  "classification": "Greed",
  "timestamp": "2026-09-02T09:00:00Z"
}
```

```json
{
  "tool": "get_etf_flows",
  "etf_type": "us-btc-spot",
  "date": "2026-09-01",
  "net_flow_usd": 312000000,
  "inflow_usd": 480000000,
  "outflow_usd": 168000000
}
```

***

### Data fields

| Tool | Key Fields |
|------|------------|
| `get_kimchi_premium` | `premium_pct`, `btc_krw_price`, `btc_global_price` |
| `get_defi_yields` | `protocol`, `pool`, `apy`, `tvl_usd`, `chain` |
| `get_etf_flows` | `etf_type`, `net_flow_usd`, `inflow_usd`, `outflow_usd`, `date` |
| `get_fear_greed` | `value`, `classification`, `timestamp` |
| `get_funding_rates` | `symbol`, `exchange`, `funding_rate_8h`, `funding_rate_apr` |
| `get_market_overview` | `btc_dominance_pct`, `total_market_cap_usd`, `top_movers` |

***

### Available Tools

| Tool | Description |
|------|-------------|
| `get_kimchi_premium` | Korean exchange premium vs global BTC/ETH price |
| `get_defi_yields` | Top DeFi yield opportunities (DefiLlama), filterable by APY and TVL |
| `get_etf_flows` | BTC/ETH spot ETF daily inflow/outflow data |
| `get_fear_greed` | Crypto Fear & Greed Index (0–100) |
| `get_funding_rates` | Perpetual funding rates across major CEXs |
| `get_market_overview` | BTC dominance, total market cap, top movers |

***

### MCP Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/mcp/v1` | POST | MCP tool call (JSON-RPC 2.0) |
| `/mcp/v1/tools` | GET | List available tools |
| `/health` | GET | Health check |

***

### Tool Parameters

#### `get_defi_yields`

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `min_apy` | number | 5.0 | Minimum APY % filter |
| `min_tvl` | number | 1,000,000 | Minimum TVL in USD |
| `limit` | integer | 20 | Max results returned |

#### `get_etf_flows`

| Parameter | Type | Values |
|-----------|------|--------|
| `etf_type` | string | `us-btc-spot`, `us-eth-spot` |

#### `get_funding_rates`

| Parameter | Type | Default |
|-----------|------|---------|
| `symbols` | array | `["BTC", "ETH", "SOL", "BNB", "XRP"]` |

***

### Cost estimation

This actor runs in **Standby mode** — you pay only for compute time while the server is active.

| Usage Pattern | Estimated Cost |
|---------------|----------------|
| Occasional queries (fewer than 10/day) | ~$0.01–0.05/day |
| Active AI agent (50–200 queries/day) | ~$0.10–0.30/day |
| Heavy pipeline use | ~$0.50+/day |

Standby actors bill per second of active compute. Idle time is not charged.

***

### FAQ

**Do I need an Apify API token to use the MCP tools?**
No. Once the actor is running via its Standby URL, your AI agent connects directly to the MCP endpoint. No Apify credentials are passed in tool calls.

**What data sources does it use?**
CoinGecko (market overview), DefiLlama (DeFi yields), SoSoValue (ETF flows), Alternative.me (Fear & Greed), and public exchange APIs (funding rates). No paid API keys required.

**Can I use this with ChatGPT or other LLMs?**
Yes. Any MCP-compatible client can connect. For non-MCP setups, you can also call the REST endpoints directly via the Standby URL.

> **Disclaimer:** Data is sourced from public APIs and provided for informational purposes only. Nothing in this actor constitutes financial advice. Always verify data before making trading decisions.

***

### Related actors

- [Kimchi Premium Tracker](https://apify.com/gochujang/kimchi-premium-tracker) — Korea exchange premium data served by this MCP server
- [Fear & Greed Tracker](https://apify.com/gochujang/fear-greed-tracker) — Fear & Greed index data accessible through this MCP integration
- [DeFi Yield APY Scanner](https://apify.com/gochujang/defi-yield-apy-scanner) — DeFi yield data that this MCP server exposes to AI agents

### Feedback

If this actor powers your AI agent setup, a review helps others find it: [Leave a review on Apify Store](https://apify.com/gochujang/crypto-data-mcp#reviews)

# Actor input Schema

## `port` (type: `integer`):

Port for the MCP HTTP server. Default 8080. Overridden by ACTOR\_STANDBY\_PORT env var.

## `maxRuntimeSecs` (type: `integer`):

Auto-shutdown after N seconds. 0 = run indefinitely (real standby mode). For testing set to 240 or less.

## Actor input object example

```json
{
  "port": 8080,
  "maxRuntimeSecs": 240
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxRuntimeSecs": 0
};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/crypto-market-data-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxRuntimeSecs": 0 }

# Run the Actor and wait for it to finish
run = client.actor("gochujang/crypto-market-data-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxRuntimeSecs": 0
}' |
apify call gochujang/crypto-market-data-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/crypto-market-data-mcp"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/X9V0rJCkWMUSdvyt8/builds/LhOZugVmPnb6AWmpT/openapi.json