@pullapi/coinmarketcap-scraper-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +94 -0
  2. package/dist/index.d.ts +2 -0
  3. package/dist/index.js +43 -0
  4. package/package.json +55 -0
  5. package/server.json +29 -0
package/README.md ADDED
@@ -0,0 +1,94 @@
1
+ # CoinMarketCap Scraper MCP Server
2
+
3
+ An MCP server that provides real-time CoinMarketCap data — cryptocurrency prices, market cap rankings, trending coins, and exchange data — for use with Claude, Cursor, and other MCP-compatible AI tools.
4
+
5
+ ## Features
6
+
7
+ - **Get Coin** — Get detailed cryptocurrency data including price, market cap, supply, and description
8
+ - **Get Listings** — Get cryptocurrency listings ranked by market cap with price and volume data
9
+ - **Get Trending** — Get trending and most visited cryptocurrencies on CoinMarketCap
10
+ - **Get Exchanges** — Get cryptocurrency exchange rankings with volume and market pair data
11
+
12
+ ## Tools
13
+
14
+ ### get_coin
15
+
16
+ Get detailed cryptocurrency data including price, market cap, supply, and description
17
+
18
+ **Parameters:**
19
+
20
+ | Name | Type | Required | Description |
21
+ |------|------|----------|-------------|
22
+ | `slug` | string | Yes | CoinMarketCap coin slug (e.g. 'bitcoin', 'ethereum') |
23
+
24
+ ### get_listings
25
+
26
+ Get cryptocurrency listings ranked by market cap with price and volume data
27
+
28
+ **Parameters:**
29
+
30
+ | Name | Type | Required | Description |
31
+ |------|------|----------|-------------|
32
+ | `start` | number | No | Starting rank position (default: 1) |
33
+ | `limit` | number | No | Number of coins to return (default: 100) |
34
+ | `sort_by` | string | No | Sort field (default: market_cap) — one of: `market_cap`, `price`, `volume_24h`, `percent_change_24h` |
35
+ | `sort_dir` | string | No | Sort direction (default: desc) — one of: `asc`, `desc` |
36
+
37
+ ### get_trending
38
+
39
+ Get trending and most visited cryptocurrencies on CoinMarketCap
40
+
41
+ ### get_exchanges
42
+
43
+ Get cryptocurrency exchange rankings with volume and market pair data
44
+
45
+ **Parameters:**
46
+
47
+ | Name | Type | Required | Description |
48
+ |------|------|----------|-------------|
49
+ | `start` | number | No | Starting rank position (default: 1) |
50
+ | `limit` | number | No | Number of exchanges to return (default: 50) |
51
+
52
+ ## Configuration
53
+
54
+ Get your API key from [RapidAPI](https://rapidapi.com/pullapi/api).
55
+
56
+ ## Usage with Claude Desktop
57
+
58
+ Add to your `claude_desktop_config.json`:
59
+
60
+ ```json
61
+ {
62
+ "mcpServers": {
63
+ "coinmarketcap": {
64
+ "command": "npx",
65
+ "args": ["-y", "@pullapi/coinmarketcap-scraper-mcp"],
66
+ "env": {
67
+ "RAPIDAPI_KEY": "your-rapidapi-key"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ ## Usage with Cursor
75
+
76
+ Add to your Cursor MCP settings (`.cursor/mcp.json`):
77
+
78
+ ```json
79
+ {
80
+ "mcpServers": {
81
+ "coinmarketcap": {
82
+ "command": "npx",
83
+ "args": ["-y", "@pullapi/coinmarketcap-scraper-mcp"],
84
+ "env": {
85
+ "RAPIDAPI_KEY": "your-rapidapi-key"
86
+ }
87
+ }
88
+ }
89
+ }
90
+ ```
91
+
92
+ ## License
93
+
94
+ MIT
package/dist/index.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/index.js ADDED
@@ -0,0 +1,43 @@
1
+ #!/usr/bin/env node
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ const mcp_core_1 = require("@pullapi/mcp-core");
5
+ const tools = [
6
+ {
7
+ name: "get_coin",
8
+ description: "Get detailed cryptocurrency data including price, market cap, supply, and description",
9
+ parameters: {
10
+ slug: { type: "string", description: "CoinMarketCap coin slug (e.g. 'bitcoin', 'ethereum')", required: true },
11
+ },
12
+ endpoint: "/coinmarketcap/coin",
13
+ },
14
+ {
15
+ name: "get_listings",
16
+ description: "Get cryptocurrency listings ranked by market cap with price and volume data",
17
+ parameters: {
18
+ start: { type: "number", description: "Starting rank position", default: 1 },
19
+ limit: { type: "number", description: "Number of coins to return", default: 100 },
20
+ sort_by: { type: "string", description: "Sort field", default: "market_cap", enum: ["market_cap", "price", "volume_24h", "percent_change_24h"] },
21
+ sort_dir: { type: "string", description: "Sort direction", default: "desc", enum: ["asc", "desc"] },
22
+ },
23
+ endpoint: "/coinmarketcap/listings",
24
+ },
25
+ {
26
+ name: "get_trending",
27
+ description: "Get trending and most visited cryptocurrencies on CoinMarketCap",
28
+ parameters: {},
29
+ endpoint: "/coinmarketcap/trending",
30
+ },
31
+ {
32
+ name: "get_exchanges",
33
+ description: "Get cryptocurrency exchange rankings with volume and market pair data",
34
+ parameters: {
35
+ start: { type: "number", description: "Starting rank position", default: 1 },
36
+ limit: { type: "number", description: "Number of exchanges to return", default: 50 },
37
+ },
38
+ endpoint: "/coinmarketcap/exchanges",
39
+ },
40
+ ];
41
+ (0, mcp_core_1.createServer)("pullapi-coinmarketcap", tools, {
42
+ rapidapiHost: "pullapi-coinmarketcap.p.rapidapi.com",
43
+ });
package/package.json ADDED
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "@pullapi/coinmarketcap-scraper-mcp",
3
+ "mcpName": "com.pullapi/coinmarketcap",
4
+ "version": "1.0.0",
5
+ "description": "CoinMarketCap MCP server — crypto prices, market listings, trending coins & exchange rankings. For Claude, Cursor & AI agents.",
6
+ "main": "dist/index.js",
7
+ "files": [
8
+ "dist",
9
+ "server.json",
10
+ "README.md"
11
+ ],
12
+ "types": "dist/index.d.ts",
13
+ "bin": {
14
+ "pullapi-coinmarketcap-scraper-mcp": "dist/index.js"
15
+ },
16
+ "scripts": {
17
+ "build": "tsc",
18
+ "dev": "tsc --watch"
19
+ },
20
+ "keywords": [
21
+ "mcp",
22
+ "mcp-server",
23
+ "model-context-protocol",
24
+ "scraper",
25
+ "claude",
26
+ "cursor",
27
+ "ai-agent",
28
+ "coinmarketcap",
29
+ "coinmarketcap-api",
30
+ "coinmarketcap-scraper",
31
+ "crypto",
32
+ "cryptocurrency",
33
+ "bitcoin",
34
+ "ethereum",
35
+ "market-data",
36
+ "token-prices",
37
+ "defi"
38
+ ],
39
+ "dependencies": {
40
+ "@pullapi/mcp-core": "*"
41
+ },
42
+ "license": "MIT",
43
+ "publishConfig": {
44
+ "access": "public"
45
+ },
46
+ "engines": {
47
+ "node": ">=18"
48
+ },
49
+ "repository": {
50
+ "type": "git",
51
+ "url": "https://github.com/basitmakine/pullapi.git",
52
+ "directory": "mcp/packages/coinmarketcap"
53
+ },
54
+ "homepage": "https://github.com/basitmakine/pullapi/tree/master/mcp/packages/coinmarketcap#readme"
55
+ }
package/server.json ADDED
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "com.pullapi/coinmarketcap",
4
+ "title": "CoinMarketCap Scraper",
5
+ "description": "Crypto prices, listings, trending coins, and exchanges",
6
+ "version": "1.0.0",
7
+ "websiteUrl": "https://pullapi.com",
8
+ "repository": {
9
+ "url": "https://github.com/basitmakine/pullapi",
10
+ "source": "github",
11
+ "subfolder": "mcp/packages/coinmarketcap"
12
+ },
13
+ "packages": [
14
+ {
15
+ "registryType": "npm",
16
+ "identifier": "@pullapi/coinmarketcap-scraper-mcp",
17
+ "version": "1.0.0",
18
+ "transport": { "type": "stdio" },
19
+ "environmentVariables": [
20
+ {
21
+ "name": "RAPIDAPI_KEY",
22
+ "description": "Your RapidAPI key from rapidapi.com",
23
+ "isRequired": true,
24
+ "isSecret": true
25
+ }
26
+ ]
27
+ }
28
+ ]
29
+ }