@coinvello/mcp 0.1.0 → 0.1.1
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.
- package/README.md +8 -10
- package/dist/client.js +1 -1
- package/dist/docs/llms-full.txt +3 -3
- package/dist/docs/llms.txt +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -8,12 +8,10 @@ inspect invoices and payments, register webhooks, verify webhook signatures, man
|
|
|
8
8
|
simulate test payments while it writes your integration.
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
|
-
npx -y
|
|
12
|
-
npx -y
|
|
11
|
+
npx -y @coinvello/mcp # stdio (what every desktop client uses)
|
|
12
|
+
npx -y @coinvello/mcp --http 3333 # Streamable HTTP on http://127.0.0.1:3333/mcp
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
Not on the npm registry yet: the package is hosted on coinvello.com (checksums in https://coinvello.com/downloads/SHA256SUMS).
|
|
16
|
-
|
|
17
15
|
```bash
|
|
18
16
|
# from a checkout of this repo instead
|
|
19
17
|
npm install && npm run build && node dist/index.js
|
|
@@ -39,7 +37,7 @@ npm install && npm run build && node dist/index.js
|
|
|
39
37
|
"mcpServers": {
|
|
40
38
|
"coinvello": {
|
|
41
39
|
"command": "npx",
|
|
42
|
-
"args": ["-y", "
|
|
40
|
+
"args": ["-y", "@coinvello/mcp"],
|
|
43
41
|
"env": { "COINVELLO_API_KEY": "cv_test_..." }
|
|
44
42
|
}
|
|
45
43
|
}
|
|
@@ -49,7 +47,7 @@ npm install && npm run build && node dist/index.js
|
|
|
49
47
|
### Claude Code
|
|
50
48
|
|
|
51
49
|
```bash
|
|
52
|
-
claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y
|
|
50
|
+
claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y @coinvello/mcp
|
|
53
51
|
```
|
|
54
52
|
|
|
55
53
|
or in `.mcp.json` at the project root (shared with the team, key via env):
|
|
@@ -59,7 +57,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
|
|
|
59
57
|
"mcpServers": {
|
|
60
58
|
"coinvello": {
|
|
61
59
|
"command": "npx",
|
|
62
|
-
"args": ["-y", "
|
|
60
|
+
"args": ["-y", "@coinvello/mcp"],
|
|
63
61
|
"env": { "COINVELLO_API_KEY": "${COINVELLO_API_KEY}" }
|
|
64
62
|
}
|
|
65
63
|
}
|
|
@@ -75,7 +73,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
|
|
|
75
73
|
"mcpServers": {
|
|
76
74
|
"coinvello": {
|
|
77
75
|
"command": "npx",
|
|
78
|
-
"args": ["-y", "
|
|
76
|
+
"args": ["-y", "@coinvello/mcp"],
|
|
79
77
|
"env": { "COINVELLO_API_KEY": "cv_test_..." }
|
|
80
78
|
}
|
|
81
79
|
}
|
|
@@ -91,7 +89,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
|
|
|
91
89
|
"mcpServers": {
|
|
92
90
|
"coinvello": {
|
|
93
91
|
"command": "npx",
|
|
94
|
-
"args": ["-y", "
|
|
92
|
+
"args": ["-y", "@coinvello/mcp"],
|
|
95
93
|
"env": { "COINVELLO_API_KEY": "cv_test_..." }
|
|
96
94
|
}
|
|
97
95
|
}
|
|
@@ -105,7 +103,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
|
|
|
105
103
|
```json
|
|
106
104
|
{
|
|
107
105
|
"servers": {
|
|
108
|
-
"coinvello": { "type": "stdio", "command": "npx", "args": ["-y", "
|
|
106
|
+
"coinvello": { "type": "stdio", "command": "npx", "args": ["-y", "@coinvello/mcp"], "env": { "COINVELLO_API_KEY": "cv_test_..." } }
|
|
109
107
|
}
|
|
110
108
|
}
|
|
111
109
|
```
|
package/dist/client.js
CHANGED
|
@@ -41,7 +41,7 @@ export class CoinVelloClient {
|
|
|
41
41
|
const headers = {
|
|
42
42
|
Authorization: `Bearer ${this.apiKey}`,
|
|
43
43
|
Accept: "application/json",
|
|
44
|
-
"User-Agent": "coinvello-mcp/0.1.
|
|
44
|
+
"User-Agent": "coinvello-mcp/0.1.1",
|
|
45
45
|
};
|
|
46
46
|
if (body !== undefined)
|
|
47
47
|
headers["Content-Type"] = "application/json";
|
package/dist/docs/llms-full.txt
CHANGED
|
@@ -34,8 +34,8 @@ CoinVello (https://coinvello.com) is a **non-custodial crypto payment processor*
|
|
|
34
34
|
DAI, `usdc:bnb` (Binance-Peg, 18 decimals), USDT on base, arbitrum (USD₮0), optimism, avalanche and
|
|
35
35
|
solana, and every Bitcoin token (`wbtc:*`, `cbbtc:*`, `btcb:*`).
|
|
36
36
|
- **Integration surfaces**: hosted checkout (pay.coinvello.com), embeddable widget
|
|
37
|
-
(`@coinvello/checkout`), REST API with SDKs (`@coinvello/sdk
|
|
38
|
-
https://coinvello.com/downloads/sdk/ until the
|
|
37
|
+
(`@coinvello/checkout`), REST API with SDKs (`@coinvello/sdk` on npm; `coinvello/sdk` and `coinvello` hosted at
|
|
38
|
+
https://coinvello.com/downloads/sdk/ until the Packagist and PyPI releases), plugins (WooCommerce available now; Shopify pending Shopify's approval; Magento 2, PrestaShop, OpenCart in testing),
|
|
39
39
|
MCP server (`@coinvello/mcp`).
|
|
40
40
|
|
|
41
41
|
## 1. Conventions
|
|
@@ -636,7 +636,7 @@ function verifyCoinVelloSignature(rawBody, header, secret, toleranceSec = 300) {
|
|
|
636
636
|
app.listen(3000);
|
|
637
637
|
```
|
|
638
638
|
|
|
639
|
-
With the SDK (`npm install
|
|
639
|
+
With the SDK (`npm install @coinvello/sdk`): `import { CoinVello } from "@coinvello/sdk"; const cv = new CoinVello(KEY);`
|
|
640
640
|
`await cv.checkoutSessions.create({...}, { idempotencyKey })`, `cv.webhooks.constructEvent(raw, header, secret)`.
|
|
641
641
|
|
|
642
642
|
### 6.3 Python (FastAPI, no SDK)
|
package/dist/docs/llms.txt
CHANGED
|
@@ -32,7 +32,7 @@ Facts an assistant should state correctly:
|
|
|
32
32
|
|
|
33
33
|
## Tools for AI agents
|
|
34
34
|
|
|
35
|
-
- [MCP server (@coinvello/mcp)](https://coinvello.com/ai): `npx -y
|
|
35
|
+
- [MCP server (@coinvello/mcp)](https://coinvello.com/ai): `npx -y @coinvello/mcp`; tools for checkout sessions, invoices, payments, wallets, webhooks, credits, records and exports, rates, assets and test payments. Descriptor at https://coinvello.com/.well-known/mcp.json.
|
|
36
36
|
- [Agent Skill (coinvello-payments)](https://coinvello.com/ai): step-by-step integration procedure, decision tree and verification checklist for Claude Code and other agent runtimes.
|
|
37
37
|
- [Tool / function definitions](https://coinvello.com/.well-known/ai-plugin.json): JSON schemas for Anthropic tool use, OpenAI function calling and Gemini function declarations.
|
|
38
38
|
- Cookbook (single-file recipes for Next.js, Express, FastAPI, Flask, Django, Laravel, Sinatra, Go and curl, each with webhook verification, plus an Excel export of a quarter of records): https://coinvello.com/ai
|
package/dist/server.d.ts
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
*/
|
|
8
8
|
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
9
9
|
export declare const SERVER_NAME = "coinvello";
|
|
10
|
-
export declare const SERVER_VERSION = "0.1.
|
|
10
|
+
export declare const SERVER_VERSION = "0.1.1";
|
|
11
11
|
export interface ServerConfig {
|
|
12
12
|
apiKey?: string;
|
|
13
13
|
baseUrl?: string;
|
package/dist/server.js
CHANGED
|
@@ -13,7 +13,7 @@ import { z } from "zod";
|
|
|
13
13
|
import { CoinVelloApiError, CoinVelloClient } from "./client.js";
|
|
14
14
|
import { verifyCoinVelloSignature } from "./verify.js";
|
|
15
15
|
export const SERVER_NAME = "coinvello";
|
|
16
|
-
export const SERVER_VERSION = "0.1.
|
|
16
|
+
export const SERVER_VERSION = "0.1.1";
|
|
17
17
|
export function configFromEnv(env = process.env) {
|
|
18
18
|
return {
|
|
19
19
|
apiKey: env.COINVELLO_API_KEY,
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@coinvello/mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"mcpName": "io.github.CoinVello/coinvello",
|
|
4
5
|
"description": "Model Context Protocol server for the CoinVello API: non-custodial crypto payments (checkout sessions, invoices, webhooks, credits) for Claude, Cursor, Windsurf, ChatGPT and other MCP clients.",
|
|
5
6
|
"license": "MIT",
|
|
6
7
|
"type": "module",
|
|
@@ -54,6 +55,5 @@
|
|
|
54
55
|
},
|
|
55
56
|
"engines": {
|
|
56
57
|
"node": ">=18"
|
|
57
|
-
}
|
|
58
|
-
"mcpName": "io.github.coinvello/coinvello"
|
|
58
|
+
}
|
|
59
59
|
}
|