@coinvello/mcp 0.1.0 → 0.1.2

package/README.md

@@ -8,17 +8,27 @@ inspect invoices and payments, register webhooks, verify webhook signatures, man
 simulate test payments while it writes your integration.
 
 ```bash
-npx -y https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz            # stdio (what every desktop client uses)
-npx -y https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz --http 3333  # Streamable HTTP on http://127.0.0.1:3333/mcp
+npx -y @coinvello/mcp            # stdio (what every desktop client uses)
+npx -y @coinvello/mcp --http 3333  # Streamable HTTP on http://127.0.0.1:3333/mcp
 ```
 
-Not on the npm registry yet: the package is hosted on coinvello.com (checksums in https://coinvello.com/downloads/SHA256SUMS).
-
 ```bash
 # from a checkout of this repo instead
 npm install && npm run build && node dist/index.js
 ```
 
+## Documentation
+
+| | |
+|---|---|
+| Website and setup for AI assistants | https://coinvello.com/ai |
+| Complete integration guide (one file, written for LLMs) | https://coinvello.com/llms-full.txt |
+| Developer docs and SDKs | https://coinvello.com/developers |
+| OpenAPI 3.1 reference | https://coinvello.com/.well-known/openapi.yaml |
+| MCP Registry | `io.github.CoinVello/coinvello` |
+| Source | https://github.com/CoinVello/coinvello-ai (`api/ai/mcp-server`) |
+| Support | support@coinvello.com |
+
 ## Configuration
 
 | Variable | Required | Meaning |
@@ -39,7 +49,7 @@ npm install && npm run build && node dist/index.js
   "mcpServers": {
     "coinvello": {
       "command": "npx",
-      "args": ["-y", "https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz"],
+      "args": ["-y", "@coinvello/mcp"],
       "env": { "COINVELLO_API_KEY": "cv_test_..." }
     }
   }
@@ -49,7 +59,7 @@ npm install && npm run build && node dist/index.js
 ### Claude Code
 
 ```bash
-claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz
+claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y @coinvello/mcp
 ```
 
 or in `.mcp.json` at the project root (shared with the team, key via env):
@@ -59,7 +69,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
   "mcpServers": {
     "coinvello": {
       "command": "npx",
-      "args": ["-y", "https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz"],
+      "args": ["-y", "@coinvello/mcp"],
       "env": { "COINVELLO_API_KEY": "${COINVELLO_API_KEY}" }
     }
   }
@@ -75,7 +85,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
   "mcpServers": {
     "coinvello": {
       "command": "npx",
-      "args": ["-y", "https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz"],
+      "args": ["-y", "@coinvello/mcp"],
       "env": { "COINVELLO_API_KEY": "cv_test_..." }
     }
   }
@@ -91,7 +101,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
   "mcpServers": {
     "coinvello": {
       "command": "npx",
-      "args": ["-y", "https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz"],
+      "args": ["-y", "@coinvello/mcp"],
       "env": { "COINVELLO_API_KEY": "cv_test_..." }
     }
   }
@@ -105,7 +115,7 @@ or in `.mcp.json` at the project root (shared with the team, key via env):
 ```json
 {
   "servers": {
-    "coinvello": { "type": "stdio", "command": "npx", "args": ["-y", "https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz"], "env": { "COINVELLO_API_KEY": "cv_test_..." } }
+    "coinvello": { "type": "stdio", "command": "npx", "args": ["-y", "@coinvello/mcp"], "env": { "COINVELLO_API_KEY": "cv_test_..." } }
   }
 }
 ```
@@ -194,4 +204,4 @@ are expected to return a clean 404 tool error there.
 - `create_wallet` rejects anything that looks like an extended private key before it leaves the machine.
 - Nothing here moves funds: CoinVello is non-custodial, and the API has no "send" operation.
 
-License MIT. Issues: support@coinvello.com
+License MIT. Source: https://github.com/CoinVello/coinvello-ai (mirror). Issues: https://github.com/CoinVello/coinvello-ai/issues or support@coinvello.com

package/dist/client.js

@@ -41,7 +41,7 @@ export class CoinVelloClient {
         const headers = {
             Authorization: `Bearer ${this.apiKey}`,
             Accept: "application/json",
-            "User-Agent": "coinvello-mcp/0.1.0",
+            "User-Agent": "coinvello-mcp/0.1.2",
         };
         if (body !== undefined)
             headers["Content-Type"] = "application/json";

package/dist/docs/llms-full.txt

@@ -34,8 +34,8 @@ CoinVello (https://coinvello.com) is a **non-custodial crypto payment processor*
   DAI, `usdc:bnb` (Binance-Peg, 18 decimals), USDT on base, arbitrum (USD₮0), optimism, avalanche and
   solana, and every Bitcoin token (`wbtc:*`, `cbbtc:*`, `btcb:*`).
 - **Integration surfaces**: hosted checkout (pay.coinvello.com), embeddable widget
-  (`@coinvello/checkout`), REST API with SDKs (`@coinvello/sdk`, `coinvello/sdk`, `coinvello`; hosted at
-  https://coinvello.com/downloads/sdk/ until the npm, Packagist and PyPI releases), plugins (WooCommerce available now; Shopify pending Shopify's approval; Magento 2, PrestaShop, OpenCart in testing),
+  (`@coinvello/checkout`), REST API with SDKs (`@coinvello/sdk` on npm; `coinvello/sdk` and `coinvello` hosted at
+  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),
   MCP server (`@coinvello/mcp`).
 
 ## 1. Conventions
@@ -636,7 +636,7 @@ function verifyCoinVelloSignature(rawBody, header, secret, toleranceSec = 300) {
 app.listen(3000);
 ```
 
-With the SDK (`npm install https://coinvello.com/downloads/sdk/coinvello-sdk-0.1.0.tgz`): `import { CoinVello } from "@coinvello/sdk"; const cv = new CoinVello(KEY);`
+With the SDK (`npm install @coinvello/sdk`): `import { CoinVello } from "@coinvello/sdk"; const cv = new CoinVello(KEY);`
 `await cv.checkoutSessions.create({...}, { idempotencyKey })`, `cv.webhooks.constructEvent(raw, header, secret)`.
 
 ### 6.3 Python (FastAPI, no SDK)

package/dist/docs/llms.txt

@@ -32,7 +32,7 @@ Facts an assistant should state correctly:
 
 ## Tools for AI agents
 
-- [MCP server (@coinvello/mcp)](https://coinvello.com/ai): `npx -y https://coinvello.com/downloads/sdk/coinvello-mcp-0.1.0.tgz`; 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.
+- [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.
 - [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.
 - [Tool / function definitions](https://coinvello.com/.well-known/ai-plugin.json): JSON schemas for Anthropic tool use, OpenAI function calling and Gemini function declarations.
 - 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

@@ -7,7 +7,7 @@
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare const SERVER_NAME = "coinvello";
-export declare const SERVER_VERSION = "0.1.0";
+export declare const SERVER_VERSION = "0.1.2";
 export interface ServerConfig {
     apiKey?: string;
     baseUrl?: string;

package/dist/server.js

@@ -13,7 +13,7 @@ import { z } from "zod";
 import { CoinVelloApiError, CoinVelloClient } from "./client.js";
 import { verifyCoinVelloSignature } from "./verify.js";
 export const SERVER_NAME = "coinvello";
-export const SERVER_VERSION = "0.1.0";
+export const SERVER_VERSION = "0.1.2";
 export function configFromEnv(env = process.env) {
     return {
         apiKey: env.COINVELLO_API_KEY,

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@coinvello/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "mcpName": "io.github.CoinVello/coinvello",
   "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.",
   "license": "MIT",
   "type": "module",
@@ -40,7 +41,13 @@
     "ai-agent"
   ],
   "homepage": "https://coinvello.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CoinVello/coinvello-ai.git",
+    "directory": "api/ai/mcp-server"
+  },
   "bugs": {
+    "url": "https://github.com/CoinVello/coinvello-ai/issues",
     "email": "support@coinvello.com"
   },
   "dependencies": {
@@ -54,6 +61,5 @@
   },
   "engines": {
     "node": ">=18"
-  },
-  "mcpName": "io.github.coinvello/coinvello"
+  }
 }