@vapi-network/mcp 0.1.1 → 0.2.0-dev.2

package/dist/server.d.ts

@@ -0,0 +1,70 @@
+import { type VapiConfig } from "@vapi-network/core";
+import type { PrivateKeyAccount } from "viem/accounts";
+import { z } from "zod";
+import { callService, type CallToolInput, type CallToolResult } from "./tools/call.js";
+export { callService, type CallToolInput, type CallToolResult };
+export type VapiServerOptions = {
+    account: PrivateKeyAccount;
+    config: VapiConfig;
+    fetchImpl?: typeof fetch;
+    ledgerPath?: string;
+    receiptsPath?: string;
+    searchesPath?: string;
+};
+type ToolResult = {
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+type ToolDefinition<Shape extends z.ZodRawShape> = {
+    description?: string;
+    deprecatedReplacement?: string;
+    inputSchema: Shape;
+    outputSchema?: z.ZodType;
+};
+type ListedTool = {
+    name: string;
+    description?: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+};
+/** Minimal MCP server implementation for stdio and deterministic in-memory tests. */
+export declare class VapiMcpServer {
+    #private;
+    registerTool<Shape extends z.ZodRawShape>(name: string, definition: ToolDefinition<Shape>, handler: (input: z.infer<z.ZodObject<Shape>>) => Promise<ToolResult>): void;
+    listTools(): Promise<{
+        tools: ListedTool[];
+    }>;
+    callTool(request: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }): Promise<ToolResult>;
+    connectStdio(): void;
+    close(): Promise<void>;
+}
+export declare function createVapiServer(options: VapiServerOptions): VapiMcpServer;
+export declare function startStdioServer(options: VapiServerOptions): Promise<VapiMcpServer>;
+export declare function loadServerConfig(): Promise<{
+    discoveryUrl: string;
+    marketplaceDiscoveryUrl: string;
+    networks: Record<string, {
+        rpcUrl: string;
+        usdc: `0x${string}`;
+        eip712Domain?: {
+            name: string;
+            version: string;
+        } | undefined;
+    }>;
+    spendCaps: {
+        perCallAtomic: string;
+        perDayAtomic: string;
+    };
+    registryFallbacks?: {
+        discoveryUrl: string;
+        marketplaceDiscoveryUrl: string;
+    }[] | undefined;
+    allowPrivateNetwork?: boolean | undefined;
+}>;

package/dist/tools/call.d.ts

@@ -0,0 +1,73 @@
+import { type LookupFn, type MarketplaceHit, type VapiConfig } from "@vapi-network/core";
+import type { PrivateKeyAccount } from "viem/accounts";
+export type CallToolInput = {
+    id?: string;
+    url?: string;
+    method?: string;
+    endpoint?: string;
+    body?: unknown;
+    maxPriceUsd?: number | string;
+    network?: string;
+    expectedPayTo?: string;
+    contentType?: string;
+};
+export type PossibleSettlement = {
+    network: string;
+    asset: string;
+    amountAtomic: string;
+    payTo: string;
+    payer: string;
+    authorizationNonce: string;
+    authorizationExpiresAt: string;
+    receipt: unknown | null;
+};
+export type PaymentRejection = {
+    httpStatus: number;
+    receipt: unknown;
+};
+export type ConfirmedSettlement = {
+    httpStatus: number;
+    receipt: unknown;
+};
+export declare class VapiCallError extends Error {
+    readonly code: "invalid_request" | "payment_rejected" | "receipt_write_failed" | "response_unreadable" | "settlement_unknown";
+    readonly possibleSettlement?: PossibleSettlement | undefined;
+    readonly name = "VapiCallError";
+    readonly paymentRejection?: PaymentRejection;
+    readonly confirmedSettlement?: ConfirmedSettlement;
+    constructor(code: "invalid_request" | "payment_rejected" | "receipt_write_failed" | "response_unreadable" | "settlement_unknown", message: string, possibleSettlement?: PossibleSettlement | undefined, options?: ErrorOptions & {
+        paymentRejection?: PaymentRejection;
+        confirmedSettlement?: ConfirmedSettlement;
+    });
+}
+export type CallToolResult = {
+    status: number;
+    body: unknown;
+    payment: null | {
+        network: string;
+        amountAtomic: string;
+        amountUsd: string;
+        asset: string;
+        payTo: string;
+        settlement: unknown | null;
+        proof: string | null;
+    };
+    expectedRequest?: {
+        contentType?: string;
+        schema?: unknown;
+    };
+};
+export type CallServiceArgs = {
+    input: CallToolInput;
+    marketplaceHit?: MarketplaceHit;
+    account: PrivateKeyAccount;
+    config: VapiConfig;
+    fetchImpl?: typeof fetch;
+    lookup?: LookupFn;
+    ledgerPath?: string;
+    receiptsPath?: string;
+    now?: Date;
+    nowMs?: () => number;
+    timeoutMs?: number;
+};
+export declare function callService(args: CallServiceArgs): Promise<CallToolResult>;

package/dist/tools/inspect.d.ts

@@ -0,0 +1,11 @@
+import { type DiscoveryEndpoint, type VapiConfig } from "@vapi-network/core";
+export type InspectToolInput = {
+    id: string;
+    endpoint?: string;
+};
+export type InspectToolResult = Omit<Pick<DiscoveryEndpoint, "name" | "method" | "url" | "price" | "description" | "operationId" | "requestContentType" | "requestSchema" | "responseContentType">, "method"> & {
+    method: string | null;
+    network?: string;
+    payment: DiscoveryEndpoint["payment"] | null;
+};
+export declare function inspectService(input: InspectToolInput, config: VapiConfig, fetchImpl?: typeof fetch): Promise<InspectToolResult>;

package/dist/tools/search.d.ts

@@ -0,0 +1 @@
+export { findMarketplaceApiByRef, resolveServiceEndpoint, searchMarketplace, type MarketplaceSearchInput, } from "@vapi-network/sources";

package/dist/tools/wallet.d.ts

@@ -0,0 +1,13 @@
+import { type VapiConfig } from "@vapi-network/core";
+import type { Address } from "viem";
+export type WalletBalance = {
+    network: string;
+    name: string;
+    usdcAtomic: string | null;
+    usdc: string | null;
+    error?: string;
+};
+export declare function getWallet(address: Address, config: VapiConfig): Promise<{
+    address: Address;
+    balances: WalletBalance[];
+}>;

package/dist/x402.d.ts

@@ -0,0 +1,19 @@
+import { EIP3009_AUTHORIZATION_TYPES, X402Error, assertMaxPrice, buildEip3009TypedData, classifySettlement, parseSettlementResponse, usdToAtomic, type Eip3009Authorization, type X402PaymentHeaders as SharedX402PaymentHeaders, type X402PaymentPayload, type X402PaymentRequirements, type X402Quote, type X402Resource, type VapiConfig } from "@vapi-network/core";
+import type { Hex } from "viem";
+import type { PrivateKeyAccount } from "viem/accounts";
+export { EIP3009_AUTHORIZATION_TYPES, X402Error, assertMaxPrice, buildEip3009TypedData, classifySettlement, parseSettlementResponse, usdToAtomic, };
+export type { Eip3009Authorization, X402PaymentPayload, X402PaymentRequirements, X402Quote, X402Resource, };
+export type X402PaymentHeaders = SharedX402PaymentHeaders & {
+    "X-PAYMENT": string;
+};
+export declare function parse402Challenge(challenge: unknown, configuredNetworks: VapiConfig["networks"], fallbackResourceUrl?: string, requiredNetwork?: string, expectedPayTo?: string): X402Quote;
+export declare function parse402Response(response: Response, configuredNetworks: VapiConfig["networks"], requiredNetwork?: string, expectedPayTo?: string): Promise<X402Quote>;
+export declare function buildX402Payment(args: {
+    account: Pick<PrivateKeyAccount, "address" | "signTypedData">;
+    quote: X402Quote;
+    nowSeconds?: number;
+    nonce?: Hex;
+}): Promise<{
+    payload: X402PaymentPayload;
+    headers: X402PaymentHeaders;
+}>;

package/package.json

@@ -1,38 +1,34 @@
 {
   "name": "@vapi-network/mcp",
-  "version": "0.1.1",
-  "description": "Agent Cash: a local-key MCP client for direct x402 payments",
-  "license": "MIT",
+  "version": "0.2.0-dev.2",
+  "description": "Local, non-custodial MCP server for discovering and paying x402 APIs",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/vAPI-Network/vapi-app.git",
-    "directory": "packages/vapi-mcp"
+    "url": "git+https://github.com/vAPI-Network/vapi-network.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/vAPI-Network/vapi-network#readme",
+  "bugs": {
+    "url": "https://github.com/vAPI-Network/vapi-network/issues"
   },
   "type": "module",
   "sideEffects": false,
   "files": [
-    "dist",
-    "types",
-    "README.md"
+    "dist"
   ],
-  "bin": {
-    "vapi-mcp": "dist/cli.js"
-  },
   "exports": {
     ".": {
-      "types": "./types/server.d.ts",
-      "import": "./dist/server.js"
-    },
-    "./x402": {
-      "types": "./types/x402.d.ts",
-      "import": "./dist/x402.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "dependencies": {},
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
   }
 }