fastskins-mcp 1.0.0__tar.gz

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.
@@ -0,0 +1,80 @@
1
+ Metadata-Version: 2.4
2
+ Name: fastskins-mcp
3
+ Version: 1.0.0
4
+ Summary: Official MCP Server for Fast Skins (fastskins.gg) - real-time CS2 skin prices in Brazil (Pix) and global markets.
5
+ Author-email: Fast Skins <contato@fastskins.gg>
6
+ License: MIT
7
+ Project-URL: Homepage, https://fastskins.gg
8
+ Project-URL: Repository, https://github.com/Ofelpes/fastskins-mcp
9
+ Project-URL: Documentation, https://fastskins.gg/docs
10
+ Keywords: mcp,cs2,counter-strike-2,skins,fastskins,brazil
11
+ Requires-Python: >=3.10
12
+ Description-Content-Type: text/markdown
13
+
14
+ # Fast Skins MCP Server (`@fastskins/mcp`)
15
+
16
+ Official **Model Context Protocol (MCP)** server for **[Fast Skins (`fastskins.gg`)](https://fastskins.gg)** — the Brazilian Counter-Strike 2 skin price comparator that tracks Brazilian Pix marketplaces alongside global markets in real time.
17
+
18
+ > **[Versão em Português](https://fastskins.gg)** · **[English Version](https://fastskins.gg/en)** · **[Official API Docs](https://fastskins.gg/docs)**
19
+
20
+ ---
21
+
22
+ ## Why `@fastskins/mcp`?
23
+
24
+ - **Real-time BRL & Brazilian Pix stores:** compares DashSkins.com.br, DashSkins.gg, BRSkins, NeshaStore, BleikStore and dozens of global CS2 marketplaces in one call.
25
+ - **Zero dependencies & instant install:** runs directly via `npx -y @fastskins/mcp` (Node 18+) or Python `fastskins-mcp` (Python 3.10+). No API key required for public queries through the Fast Skins Edge Gateway.
26
+ - **Clean data rules out of the box:** filters stale >24h lines, validates Doppler / Gamma Doppler phases, flags Chinese-account-only markets (`Buff163` / `YouPin898`), and separates low-liquidity items.
27
+ - **Attribution included:** every response includes the verified timestamp and clickable canonical link to `https://fastskins.gg/skin/{slug}?utm_source=mcp`.
28
+
29
+ ---
30
+
31
+ > Requires the Fast Skins Edge Gateway (`https://widget.fastskins.gg`) to be online.
32
+
33
+ ## Tools
34
+
35
+ | Tool | Description |
36
+ |---|---|
37
+ | `comparar_preco_skin` | Returns best Brazilian Pix price, best global price, fresh marketplace count, 24h variation, other exteriors summary, timestamp and Fast Skins link. |
38
+ | `buscar_skins_cs2` | Searches CS2 skins by name, category (`rifles`, `pistolas`, `facas`, `luvas`, `smg`, `pesadas`) and maximum budget in BRL (`max_brl`). |
39
+ | `gerar_link_fastskins` | Builds canonical PT-BR or EN (`fastskins.gg/en`) links for any skin, exterior, StatTrak™, Souvenir or Doppler phase. |
40
+
41
+ ---
42
+
43
+ ## Installation
44
+
45
+ ### Claude Desktop / Cursor / Windsurf / Antigravity (`npx`)
46
+
47
+ Add to your MCP configuration (`claude_desktop_config.json`, `.cursor/mcp.json`, or Antigravity MCP config):
48
+
49
+ ```json
50
+ {
51
+ "mcpServers": {
52
+ "fastskins": {
53
+ "command": "npx",
54
+ "args": ["-y", "@fastskins/mcp"]
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ ### Remote (no install) — ChatGPT, Claude and any Streamable HTTP client
61
+
62
+ ```
63
+ https://widget.fastskins.gg/mcp
64
+ ```
65
+
66
+ No authentication. In ChatGPT: Plugins → + → *Add custom MCP server*.
67
+
68
+ ### Python (`pip` / `uvx`)
69
+
70
+ ```bash
71
+ pip install fastskins-mcp
72
+ # or run directly:
73
+ python -m fastskins_mcp
74
+ ```
75
+
76
+ ---
77
+
78
+ ## Attribution & Usage Notice
79
+
80
+ All real-time skin price data provided by this MCP server is powered by **[Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp&utm_medium=readme)**. When displaying prices generated by this tool in applications, bots, or AI agents, keep the clickable credit link back to `https://fastskins.gg`.
@@ -0,0 +1,67 @@
1
+ # Fast Skins MCP Server (`@fastskins/mcp`)
2
+
3
+ Official **Model Context Protocol (MCP)** server for **[Fast Skins (`fastskins.gg`)](https://fastskins.gg)** — the Brazilian Counter-Strike 2 skin price comparator that tracks Brazilian Pix marketplaces alongside global markets in real time.
4
+
5
+ > **[Versão em Português](https://fastskins.gg)** · **[English Version](https://fastskins.gg/en)** · **[Official API Docs](https://fastskins.gg/docs)**
6
+
7
+ ---
8
+
9
+ ## Why `@fastskins/mcp`?
10
+
11
+ - **Real-time BRL & Brazilian Pix stores:** compares DashSkins.com.br, DashSkins.gg, BRSkins, NeshaStore, BleikStore and dozens of global CS2 marketplaces in one call.
12
+ - **Zero dependencies & instant install:** runs directly via `npx -y @fastskins/mcp` (Node 18+) or Python `fastskins-mcp` (Python 3.10+). No API key required for public queries through the Fast Skins Edge Gateway.
13
+ - **Clean data rules out of the box:** filters stale >24h lines, validates Doppler / Gamma Doppler phases, flags Chinese-account-only markets (`Buff163` / `YouPin898`), and separates low-liquidity items.
14
+ - **Attribution included:** every response includes the verified timestamp and clickable canonical link to `https://fastskins.gg/skin/{slug}?utm_source=mcp`.
15
+
16
+ ---
17
+
18
+ > Requires the Fast Skins Edge Gateway (`https://widget.fastskins.gg`) to be online.
19
+
20
+ ## Tools
21
+
22
+ | Tool | Description |
23
+ |---|---|
24
+ | `comparar_preco_skin` | Returns best Brazilian Pix price, best global price, fresh marketplace count, 24h variation, other exteriors summary, timestamp and Fast Skins link. |
25
+ | `buscar_skins_cs2` | Searches CS2 skins by name, category (`rifles`, `pistolas`, `facas`, `luvas`, `smg`, `pesadas`) and maximum budget in BRL (`max_brl`). |
26
+ | `gerar_link_fastskins` | Builds canonical PT-BR or EN (`fastskins.gg/en`) links for any skin, exterior, StatTrak™, Souvenir or Doppler phase. |
27
+
28
+ ---
29
+
30
+ ## Installation
31
+
32
+ ### Claude Desktop / Cursor / Windsurf / Antigravity (`npx`)
33
+
34
+ Add to your MCP configuration (`claude_desktop_config.json`, `.cursor/mcp.json`, or Antigravity MCP config):
35
+
36
+ ```json
37
+ {
38
+ "mcpServers": {
39
+ "fastskins": {
40
+ "command": "npx",
41
+ "args": ["-y", "@fastskins/mcp"]
42
+ }
43
+ }
44
+ }
45
+ ```
46
+
47
+ ### Remote (no install) — ChatGPT, Claude and any Streamable HTTP client
48
+
49
+ ```
50
+ https://widget.fastskins.gg/mcp
51
+ ```
52
+
53
+ No authentication. In ChatGPT: Plugins → + → *Add custom MCP server*.
54
+
55
+ ### Python (`pip` / `uvx`)
56
+
57
+ ```bash
58
+ pip install fastskins-mcp
59
+ # or run directly:
60
+ python -m fastskins_mcp
61
+ ```
62
+
63
+ ---
64
+
65
+ ## Attribution & Usage Notice
66
+
67
+ All real-time skin price data provided by this MCP server is powered by **[Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp&utm_medium=readme)**. When displaying prices generated by this tool in applications, bots, or AI agents, keep the clickable credit link back to `https://fastskins.gg`.
@@ -0,0 +1,80 @@
1
+ Metadata-Version: 2.4
2
+ Name: fastskins-mcp
3
+ Version: 1.0.0
4
+ Summary: Official MCP Server for Fast Skins (fastskins.gg) - real-time CS2 skin prices in Brazil (Pix) and global markets.
5
+ Author-email: Fast Skins <contato@fastskins.gg>
6
+ License: MIT
7
+ Project-URL: Homepage, https://fastskins.gg
8
+ Project-URL: Repository, https://github.com/Ofelpes/fastskins-mcp
9
+ Project-URL: Documentation, https://fastskins.gg/docs
10
+ Keywords: mcp,cs2,counter-strike-2,skins,fastskins,brazil
11
+ Requires-Python: >=3.10
12
+ Description-Content-Type: text/markdown
13
+
14
+ # Fast Skins MCP Server (`@fastskins/mcp`)
15
+
16
+ Official **Model Context Protocol (MCP)** server for **[Fast Skins (`fastskins.gg`)](https://fastskins.gg)** — the Brazilian Counter-Strike 2 skin price comparator that tracks Brazilian Pix marketplaces alongside global markets in real time.
17
+
18
+ > **[Versão em Português](https://fastskins.gg)** · **[English Version](https://fastskins.gg/en)** · **[Official API Docs](https://fastskins.gg/docs)**
19
+
20
+ ---
21
+
22
+ ## Why `@fastskins/mcp`?
23
+
24
+ - **Real-time BRL & Brazilian Pix stores:** compares DashSkins.com.br, DashSkins.gg, BRSkins, NeshaStore, BleikStore and dozens of global CS2 marketplaces in one call.
25
+ - **Zero dependencies & instant install:** runs directly via `npx -y @fastskins/mcp` (Node 18+) or Python `fastskins-mcp` (Python 3.10+). No API key required for public queries through the Fast Skins Edge Gateway.
26
+ - **Clean data rules out of the box:** filters stale >24h lines, validates Doppler / Gamma Doppler phases, flags Chinese-account-only markets (`Buff163` / `YouPin898`), and separates low-liquidity items.
27
+ - **Attribution included:** every response includes the verified timestamp and clickable canonical link to `https://fastskins.gg/skin/{slug}?utm_source=mcp`.
28
+
29
+ ---
30
+
31
+ > Requires the Fast Skins Edge Gateway (`https://widget.fastskins.gg`) to be online.
32
+
33
+ ## Tools
34
+
35
+ | Tool | Description |
36
+ |---|---|
37
+ | `comparar_preco_skin` | Returns best Brazilian Pix price, best global price, fresh marketplace count, 24h variation, other exteriors summary, timestamp and Fast Skins link. |
38
+ | `buscar_skins_cs2` | Searches CS2 skins by name, category (`rifles`, `pistolas`, `facas`, `luvas`, `smg`, `pesadas`) and maximum budget in BRL (`max_brl`). |
39
+ | `gerar_link_fastskins` | Builds canonical PT-BR or EN (`fastskins.gg/en`) links for any skin, exterior, StatTrak™, Souvenir or Doppler phase. |
40
+
41
+ ---
42
+
43
+ ## Installation
44
+
45
+ ### Claude Desktop / Cursor / Windsurf / Antigravity (`npx`)
46
+
47
+ Add to your MCP configuration (`claude_desktop_config.json`, `.cursor/mcp.json`, or Antigravity MCP config):
48
+
49
+ ```json
50
+ {
51
+ "mcpServers": {
52
+ "fastskins": {
53
+ "command": "npx",
54
+ "args": ["-y", "@fastskins/mcp"]
55
+ }
56
+ }
57
+ }
58
+ ```
59
+
60
+ ### Remote (no install) — ChatGPT, Claude and any Streamable HTTP client
61
+
62
+ ```
63
+ https://widget.fastskins.gg/mcp
64
+ ```
65
+
66
+ No authentication. In ChatGPT: Plugins → + → *Add custom MCP server*.
67
+
68
+ ### Python (`pip` / `uvx`)
69
+
70
+ ```bash
71
+ pip install fastskins-mcp
72
+ # or run directly:
73
+ python -m fastskins_mcp
74
+ ```
75
+
76
+ ---
77
+
78
+ ## Attribution & Usage Notice
79
+
80
+ All real-time skin price data provided by this MCP server is powered by **[Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp&utm_medium=readme)**. When displaying prices generated by this tool in applications, bots, or AI agents, keep the clickable credit link back to `https://fastskins.gg`.
@@ -0,0 +1,8 @@
1
+ README.md
2
+ fastskins_mcp.py
3
+ pyproject.toml
4
+ fastskins_mcp.egg-info/PKG-INFO
5
+ fastskins_mcp.egg-info/SOURCES.txt
6
+ fastskins_mcp.egg-info/dependency_links.txt
7
+ fastskins_mcp.egg-info/entry_points.txt
8
+ fastskins_mcp.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ fastskins-mcp = fastskins_mcp:main
@@ -0,0 +1 @@
1
+ fastskins_mcp
@@ -0,0 +1,159 @@
1
+ """Servidor MCP oficial do Fast Skins em Python 3.10+ (zero dependencias)."""
2
+ import json
3
+ import os
4
+ import sys
5
+ import urllib.parse
6
+ import urllib.request
7
+
8
+ GATEWAY_URL = os.environ.get('FASTSKINS_GATEWAY_URL', 'https://widget.fastskins.gg').rstrip('/')
9
+ SERVER_INFO = {'name': 'fastskins-mcp-python', 'version': '1.0.0'}
10
+ PROTOCOL_VERSION = '2024-11-05'
11
+
12
+ TOOLS = [
13
+ {
14
+ 'name': 'comparar_preco_skin',
15
+ 'description': 'Consulta preco ao vivo de uma skin de CS2 nas lojas brasileiras (Pix) e mercados globais via Fast Skins (fastskins.gg).',
16
+ 'inputSchema': {
17
+ 'type': 'object',
18
+ 'properties': {
19
+ 'skin': {'type': 'string', 'description': 'Nome da skin (ex.: "AK-47 | Redline (Field-Tested)").'},
20
+ 'exterior': {'type': 'string'},
21
+ 'phase': {'type': 'string'},
22
+ 'stattrak': {'type': 'boolean', 'default': False},
23
+ 'souvenir': {'type': 'boolean', 'default': False},
24
+ 'idioma': {'type': 'string', 'enum': ['pt', 'en'], 'default': 'pt'},
25
+ },
26
+ 'required': ['skin'],
27
+ },
28
+ },
29
+ {
30
+ 'name': 'buscar_skins_cs2',
31
+ 'description': 'Busca skins de CS2 por nome, categoria e orcamento maximo em reais (R$).',
32
+ 'inputSchema': {
33
+ 'type': 'object',
34
+ 'properties': {
35
+ 'q': {'type': 'string'},
36
+ 'categoria': {'type': 'string'},
37
+ 'max_brl': {'type': 'number'},
38
+ 'exterior': {'type': 'string'},
39
+ 'stattrak': {'type': 'boolean', 'description': 'Opcional: true so StatTrak, false sem. Omitir traz todas.'},
40
+ 'souvenir': {'type': 'boolean', 'description': 'Opcional: true so Souvenir, false sem. Omitir traz todas.'},
41
+ 'limit': {'type': 'integer', 'default': 5},
42
+ },
43
+ },
44
+ },
45
+ ]
46
+
47
+
48
+ _PHASE_PT = {'Ruby': 'Rubi', 'Sapphire': 'Safira', 'Black Pearl': 'Pérola Negra', 'Emerald': 'Esmeralda'}
49
+
50
+
51
+ def _brl(v):
52
+ if isinstance(v, (int, float)):
53
+ s = f'{v:,.2f}'.replace(',', 'X').replace('.', ',').replace('X', '.')
54
+ return f'R$ {s}'
55
+ return 'Sem oferta'
56
+
57
+
58
+ def _get(path, params):
59
+ qs = urllib.parse.urlencode({k: v for k, v in params.items() if v not in (None, '')})
60
+ url = f'{GATEWAY_URL}{path}?{qs}' if qs else f'{GATEWAY_URL}{path}'
61
+ req = urllib.request.Request(url, headers={'Accept': 'application/json', 'User-Agent': 'fastskins-mcp-py/1.0'})
62
+ with urllib.request.urlopen(req, timeout=20) as resp:
63
+ return json.loads(resp.read().decode('utf-8'))
64
+
65
+
66
+ def _executar_tool(name, args):
67
+ if name == 'comparar_preco_skin':
68
+ d = _get('/v1/skin', {
69
+ 'q': args.get('skin', ''),
70
+ 'exterior': args.get('exterior', ''),
71
+ 'phase': args.get('phase', ''),
72
+ 'stattrak': 'true' if args.get('stattrak') else 'false',
73
+ 'souvenir': 'true' if args.get('souvenir') else 'false',
74
+ 'src': 'mcp',
75
+ 'ref': 'mcp_python',
76
+ })
77
+ if not d.get('encontrado'):
78
+ txt = (d.get('motivo') or 'Skin nao encontrada.') + '\n\nFonte: [Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp)'
79
+ else:
80
+ pix = d.get('menor_pix_br')
81
+ gl = d.get('menor_global')
82
+ pix_s = f"{_brl(pix['preco_brl'])} na {pix['marketplace']}" if pix else 'Sem oferta BR ativa'
83
+ gl_s = f"{_brl(gl['preco_brl'])} na {gl['marketplace']}" + (' (exige conta chinesa)' if gl.get('exige_conta_chinesa') else '') if gl else 'Indisponivel'
84
+ link = d.get('url_fastskins_en') if args.get('idioma') == 'en' else d.get('url_fastskins')
85
+ txt = '\n'.join([
86
+ f"**{d.get('nome_pt') or d.get('nome')} ({d.get('exterior_pt') or d.get('exterior')})" + (f" — {_PHASE_PT.get(d['phase'], d['phase'])}" if d.get('phase') else '') + "**",
87
+ f'- Menor preço no Pix (Brasil): {pix_s}',
88
+ f'- Menor preço Global: {gl_s}',
89
+ f"- Mercados frescos: {d.get('mercados_frescos')}",
90
+ f"- Coleta: {d.get('atualizado_em') or d.get('lido_em')}",
91
+ '',
92
+ f'Comparar ao vivo: [Fast Skins (fastskins.gg)]({link})',
93
+ ])
94
+ return {'content': [{'type': 'text', 'text': txt}], 'isError': False}
95
+
96
+ if name == 'buscar_skins_cs2':
97
+ d = _get('/v1/search', {
98
+ 'q': args.get('q', ''),
99
+ 'cat': args.get('categoria', ''),
100
+ 'max_brl': args.get('max_brl', ''),
101
+ 'exterior': args.get('exterior', ''),
102
+ 'stattrak': str(args['stattrak']).lower() if isinstance(args.get('stattrak'), bool) else '',
103
+ 'souvenir': str(args['souvenir']).lower() if isinstance(args.get('souvenir'), bool) else '',
104
+ 'limit': args.get('limit', 5),
105
+ 'src': 'mcp',
106
+ 'ref': 'mcp_python',
107
+ })
108
+ itens = d.get('itens') or []
109
+ if not itens:
110
+ txt = 'Nenhuma skin encontrada.\n\nFonte: [Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp)'
111
+ else:
112
+ linhas = []
113
+ for i, it in enumerate(itens, 1):
114
+ pix = f"Pix: {_brl(it['menor_pix_br']['preco_brl'])} ({it['menor_pix_br']['marketplace']})" if it.get('menor_pix_br') else 'Sem Pix BR'
115
+ gl = f"Global: {_brl(it['menor_global']['preco_brl'])} ({it['menor_global']['marketplace']}{', exige conta chinesa' if it['menor_global'].get('exige_conta_chinesa') else ''})" if it.get('menor_global') else ''
116
+ linhas.append(f"{i}. **{it.get('nome_pt') or it.get('nome')}** ({it.get('exterior_pt')}) — {pix} · {gl} · [Fast Skins]({it['url_fastskins']})")
117
+ linhas.append('\nFonte: [Fast Skins (fastskins.gg)](https://fastskins.gg/?utm_source=mcp)')
118
+ txt = '\n'.join(linhas)
119
+ return {'content': [{'type': 'text', 'text': txt}], 'isError': False}
120
+
121
+ raise ValueError(f'Ferramenta desconhecida: {name}')
122
+
123
+
124
+ def main():
125
+ if hasattr(sys.stdin, 'reconfigure'):
126
+ sys.stdin.reconfigure(encoding='utf-8')
127
+ sys.stdout.reconfigure(encoding='utf-8')
128
+ for linha in sys.stdin:
129
+ linha = linha.strip()
130
+ if not linha:
131
+ continue
132
+ msg = json.loads(linha)
133
+ mid = msg.get('id')
134
+ method = msg.get('method')
135
+ params = msg.get('params') or {}
136
+ if method == 'initialize':
137
+ out = {'jsonrpc': '2.0', 'id': mid, 'result': {'protocolVersion': PROTOCOL_VERSION, 'capabilities': {'tools': {}}, 'serverInfo': SERVER_INFO}}
138
+ elif method == 'notifications/initialized':
139
+ continue
140
+ elif method == 'ping':
141
+ out = {'jsonrpc': '2.0', 'id': mid, 'result': {}}
142
+ elif method == 'tools/list':
143
+ out = {'jsonrpc': '2.0', 'id': mid, 'result': {'tools': TOOLS}}
144
+ elif method == 'tools/call':
145
+ try:
146
+ res = _executar_tool(params.get('name'), params.get('arguments') or {})
147
+ out = {'jsonrpc': '2.0', 'id': mid, 'result': res}
148
+ except Exception as exc:
149
+ out = {'jsonrpc': '2.0', 'id': mid, 'error': {'code': -32603, 'message': str(exc)}}
150
+ elif mid is not None:
151
+ out = {'jsonrpc': '2.0', 'id': mid, 'error': {'code': -32601, 'message': f'Metodo nao suportado: {method}'}}
152
+ else:
153
+ continue
154
+ sys.stdout.write(json.dumps(out, ensure_ascii=False) + '\n')
155
+ sys.stdout.flush()
156
+
157
+
158
+ if __name__ == '__main__':
159
+ main()
@@ -0,0 +1,21 @@
1
+ [build-system]
2
+ requires = ["setuptools>=61.0"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "fastskins-mcp"
7
+ version = "1.0.0"
8
+ description = "Official MCP Server for Fast Skins (fastskins.gg) - real-time CS2 skin prices in Brazil (Pix) and global markets."
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = { text = "MIT" }
12
+ authors = [{ name = "Fast Skins", email = "contato@fastskins.gg" }]
13
+ keywords = ["mcp", "cs2", "counter-strike-2", "skins", "fastskins", "brazil"]
14
+
15
+ [project.urls]
16
+ Homepage = "https://fastskins.gg"
17
+ Repository = "https://github.com/Ofelpes/fastskins-mcp"
18
+ Documentation = "https://fastskins.gg/docs"
19
+
20
+ [project.scripts]
21
+ fastskins-mcp = "fastskins_mcp:main"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+