@apiosk/mcp 1.3.0 → 1.3.1

package/README.md

@@ -1,7 +1,24 @@
+<p align="center">
+  <img src="https://apiosk.com/logo.svg" alt="Apiosk" width="120" />
+</p>
+
 # Apiosk MCP Server
 
+**AI-native payments for tools and APIs.** Discover, pay for, execute, and publish monetized APIs directly from your agent — over USDC/x402 or prepaid credits — through the Model Context Protocol.
+
+`payments` · `finance` · `x402` · `commerce` · `crypto`
+
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.obcraft%2Fapiosk--mcp-2ea44f)](https://registry.modelcontextprotocol.io)
+[![npm](https://img.shields.io/npm/v/@apiosk/mcp?label=npm%20%40apiosk%2Fmcp)](https://www.npmjs.com/package/@apiosk/mcp)
+[![PyPI](https://img.shields.io/pypi/v/apiosk-mcp?label=PyPI%20apiosk-mcp)](https://pypi.org/project/apiosk-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](#license)
+
 Official MCP server for discovering, paying for, and publishing Apiosk APIs.
 
+- **Listed in the [official MCP Registry](https://registry.modelcontextprotocol.io)** as `io.github.obcraft/apiosk-mcp`.
+- **Hosted endpoint:** `https://mcp.apiosk.com/mcp` (streamable HTTP, OAuth-protected for paid tools).
+- **Local stdio package:** `npx -y @apiosk/mcp` or `uvx apiosk-mcp` for wallet + publish tools.
+
 ## Quick Start
 
 ### Package names
@@ -46,7 +63,7 @@ uvx apiosk-mcp
 ```
 
 The PyPI launcher requires Node.js 20+ and `npx` on `PATH`. By default it runs
-`npx -y @apiosk/mcp@1.3.0`; set `APIOSK_MCP_NPM_PACKAGE=@apiosk/mcp@next` to
+`npx -y @apiosk/mcp@1.3.1`; set `APIOSK_MCP_NPM_PACKAGE=@apiosk/mcp@next` to
 override the npm package spec.
 
 ### Publishing packages
@@ -61,7 +78,7 @@ npm publish --access public
 ```bash
 python3 -m pip install --upgrade build twine
 python3 -m build
-python3 -m twine upload dist/apiosk_mcp-1.3.0*
+python3 -m twine upload dist/apiosk_mcp-1.3.1*
 ```
 
 After both uploads are live, the MCP registry package fields are:
@@ -126,6 +143,40 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 }
 ```
 
+### VS Code
+
+Add the server with the CLI:
+
+```bash
+code --add-mcp '{"name":"apiosk","command":"npx","args":["-y","@apiosk/mcp"]}'
+```
+
+Or create `.vscode/mcp.json` in your workspace (VS Code uses a `servers` key):
+
+```json
+{
+  "servers": {
+    "apiosk": {
+      "command": "npx",
+      "args": ["-y", "@apiosk/mcp"]
+    }
+  }
+}
+```
+
+To use the hosted endpoint instead of the local package:
+
+```json
+{
+  "servers": {
+    "apiosk": {
+      "type": "http",
+      "url": "https://mcp.apiosk.com/mcp"
+    }
+  }
+}
+```
+
 ### Cursor
 
 ```json

package/dxt.json

@@ -1,10 +1,13 @@
 {
   "name": "apiosk-mcp",
-  "version": "1.3.0",
-  "description": "Official MCP server for browsing, paying for, and publishing Apiosk APIs",
+  "version": "1.3.1",
+  "description": "AI-native payments: discover, pay for, execute, and publish monetized APIs through MCP.",
   "author": "Apiosk",
   "license": "MIT",
-  "repository": "https://github.com/apiosk/apiosk-mcp",
+  "homepage": "https://apiosk.com",
+  "icon": "https://apiosk.com/logo.svg",
+  "keywords": ["payments", "finance", "x402", "commerce", "crypto"],
+  "repository": "https://github.com/obcraft/apiosk-mcp",
   "mcp": {
     "command": "node",
     "args": ["index.mjs"]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apiosk/mcp",
-  "version": "1.3.0",
-  "description": "Official MCP server for browsing, paying for, and publishing Apiosk APIs",
+  "version": "1.3.1",
+  "description": "AI-native payments: discover, pay for, execute, and publish monetized APIs through MCP.",
   "mcpName": "io.github.obcraft/apiosk-mcp",
   "main": "index.mjs",
   "exports": {
@@ -28,9 +28,12 @@
     "apiosk",
     "api",
     "model-context-protocol",
-    "x402",
     "agent-tools",
-    "payments"
+    "payments",
+    "finance",
+    "x402",
+    "commerce",
+    "crypto"
   ],
   "author": "Apiosk",
   "license": "MIT",
@@ -41,10 +44,10 @@
   "homepage": "https://apiosk.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/apiosk/mcp.git"
+    "url": "https://github.com/obcraft/apiosk-mcp.git"
   },
   "bugs": {
-    "url": "https://github.com/apiosk/mcp/issues"
+    "url": "https://github.com/obcraft/apiosk-mcp/issues"
   },
   "publishConfig": {
     "access": "public"

package/server.json

@@ -2,8 +2,21 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.obcraft/apiosk-mcp",
   "title": "Apiosk",
-  "description": "Discover, pay for, execute, and publish Apiosk APIs through MCP.",
-  "version": "1.3.0",
+  "description": "AI-native payments: discover, pay for, execute, and publish monetized APIs through MCP.",
+  "version": "1.3.1",
+  "websiteUrl": "https://apiosk.com",
+  "icons": [
+    {
+      "src": "https://apiosk.com/logo.svg",
+      "mimeType": "image/svg+xml",
+      "sizes": ["any"]
+    },
+    {
+      "src": "https://apiosk.com/apple-touch-icon.png",
+      "mimeType": "image/png",
+      "sizes": ["180x180"]
+    }
+  ],
   "repository": {
     "url": "https://github.com/obcraft/apiosk-mcp",
     "source": "github"
@@ -13,5 +26,11 @@
       "type": "streamable-http",
       "url": "https://mcp.apiosk.com/mcp"
     }
-  ]
+  ],
+  "_meta": {
+    "com.apiosk": {
+      "tags": ["payments", "finance", "x402", "commerce", "crypto"],
+      "categories": ["payments", "finance"]
+    }
+  }
 }

package/src/create-server.mjs

@@ -7,7 +7,7 @@ import { createApioskMcpRuntime } from "./runtime.mjs";
 
 export const SERVER_INFO = {
   name: "apiosk-mcp",
-  version: "1.3.0",
+  version: "1.3.1",
 };
 
 function resolveRuntime(options = {}) {

package/src/runtime.mjs

@@ -824,6 +824,18 @@ function buildCatalogEntry(api, toolName) {
 function buildDynamicTools(catalog, reservedTools) {
   const tools = [];
   const toolIndex = new Map();
+
+  // Per-API "dynamic" tools surface one MCP tool per gateway listing, which
+  // DUPLICATES every paid API. Exposing them also lets the provider-portal MCP
+  // import create separate /tools/<slug> gateway endpoints that undercut (or
+  // give away for free) the real API listings. Agents must instead discover via
+  // apiosk_search / apiosk_explore and call any API through apiosk_execute,
+  // which settles the real per-call price. So these are OFF by default; set
+  // APIOSK_MCP_DYNAMIC_TOOLS=true to opt back in.
+  if (process.env.APIOSK_MCP_DYNAMIC_TOOLS !== "true") {
+    return { tools, toolIndex };
+  }
+
   const usedNames = new Set(reservedTools.map((tool) => tool.name));
 
   for (const api of catalog) {