@vapi-network/mcp 0.3.0 → 0.5.0

package/dist/server.d.ts

@@ -1,6 +1,8 @@
 import { type SecretStore, type VapiPaymentAccount, type VapiConfig, type WalletStore } from "@vapi-network/core";
 import { z } from "zod";
 import { callService, type CallToolInput, type CallToolResult } from "./tools/call.js";
+import { type AuthAgentLinkOverrides } from "./tools/auth.js";
+import { type RouterCoreOverrides } from "./tools/router.js";
 export { callService, type CallToolInput, type CallToolResult };
 export type VapiServerOptions = {
     /** The wallet unlocked before stdio was connected. */
@@ -20,6 +22,10 @@ export type VapiServerOptions = {
     passphrase?: (() => string | Promise<string>) | undefined;
     /** The OS secret store `vapi unlock` writes to; see `WalletSession`. */
     secretStore?: SecretStore | undefined;
+    /** Device-link functions and API base overridden by deterministic tests. */
+    agentLink?: AuthAgentLinkOverrides | undefined;
+    /** Core Router functions overridden by deterministic tests. */
+    router?: RouterCoreOverrides | undefined;
 };
 type ToolResult = {
     isError?: boolean;
@@ -33,6 +39,7 @@ type ToolDefinition<Shape extends z.ZodRawShape> = {
     description?: string;
     deprecatedReplacement?: string;
     inputSchema: Shape;
+    strictInput?: boolean;
     outputSchema?: z.ZodType;
 };
 type ListedTool = {

package/dist/tools/auth.d.ts

@@ -0,0 +1,81 @@
+import type { SecretStore, WalletStore } from "@vapi-network/core";
+import { pollDeviceLink, saveAgentLink, startDeviceLink } from "@vapi-network/core/agent-link";
+import { z } from "zod";
+import type { WalletSession } from "../wallet-session.js";
+export declare const authStatusTool: {
+    description: string;
+    inputSchema: {
+        wallet: z.ZodOptional<z.ZodString>;
+    };
+    outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        linked: z.ZodLiteral<false>;
+        wallet: z.ZodString;
+        address: z.ZodString;
+        pending: z.ZodOptional<z.ZodObject<{
+            userCode: z.ZodString;
+            verificationUriComplete: z.ZodURL;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        linked: z.ZodLiteral<true>;
+        owner: z.ZodString;
+        label: z.ZodString;
+        scopes: z.ZodArray<z.ZodString>;
+        linkedAt: z.ZodISODateTime;
+        router: z.ZodBoolean;
+        wallet: z.ZodString;
+        address: z.ZodString;
+        pending: z.ZodOptional<z.ZodObject<{
+            userCode: z.ZodString;
+            verificationUriComplete: z.ZodURL;
+            expiresAt: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        lastError: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "linked">;
+};
+export declare const authLinkTool: {
+    description: string;
+    inputSchema: {
+        label: z.ZodOptional<z.ZodString>;
+    };
+    outputSchema: z.ZodObject<{
+        wallet: z.ZodString;
+        address: z.ZodString;
+        userCode: z.ZodString;
+        verificationUriComplete: z.ZodURL;
+        expiresAt: z.ZodISODateTime;
+    }, z.core.$strip>;
+};
+export type AuthAgentLinkOverrides = {
+    apiBase?: string | undefined;
+    startDeviceLink?: typeof startDeviceLink | undefined;
+    pollDeviceLink?: typeof pollDeviceLink | undefined;
+    saveAgentLink?: typeof saveAgentLink | undefined;
+    now?: (() => number) | undefined;
+};
+export type AuthToolsOptions = AuthAgentLinkOverrides & {
+    session: WalletSession;
+    secrets: SecretStore;
+    wallets?: WalletStore | undefined;
+    fetchImpl: typeof fetch;
+    apiBase: string;
+};
+type ToolResult = {
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/** One server instance's link state. No device code or token crosses the tool boundary. */
+export declare function createAuthTools(options: AuthToolsOptions): {
+    link(input: {
+        label?: string;
+    }): Promise<ToolResult>;
+    status(input: {
+        wallet?: string;
+    }): Promise<ToolResult>;
+};
+export {};

package/dist/tools/call.d.ts

@@ -1,4 +1,4 @@
-import { type LookupFn, type MarketplaceHit, type SpendCaps, type VapiPaymentAccount, type VapiConfig, type WalletName } from "@vapi-network/core";
+import { type ListingVerification, type LookupFn, type MarketplaceHit, type SpendCaps, type VapiPaymentAccount, type VapiConfig, type WalletName } from "@vapi-network/core";
 export type CallToolInput = {
     id?: string;
     url?: string;
@@ -16,6 +16,7 @@ export type PossibleSettlement = {
     amountAtomic: string;
     payTo: string;
     payer: string;
+    paymentId?: string;
     authorizationNonce?: string;
     authorizationExpiresAt?: string;
     authorizationTransaction?: string;
@@ -43,6 +44,11 @@ export declare class VapiCallError extends Error {
 export type CallToolResult = {
     status: number;
     body: unknown;
+    /**
+     * How far the paid listing got through vAPI review. Absent when there was no
+     * listing to disclose — a call made against an explicit URL.
+     */
+    verification?: ListingVerification;
     outcome?: "signed_in";
     payment: null | {
         network: string;

package/dist/tools/inspect.d.ts

@@ -1,4 +1,4 @@
-import { type DiscoveryEndpoint, type ListingFee, type ListingGroup, type VapiConfig } from "@vapi-network/core";
+import { type DiscoveryEndpoint, type ListingConformance, type ListingFee, type ListingGroup, type ListingIdentity, type ListingLiveness, type ListingVerification, type VapiConfig } from "@vapi-network/core";
 export type InspectToolInput = {
     id: string;
     endpoint?: string;
@@ -9,6 +9,17 @@ export type InspectToolResult = Omit<Pick<DiscoveryEndpoint, "name" | "method" |
     /** Registry-owned listing disclosures; absent when the registry omits them. */
     group?: ListingGroup;
     fee?: ListingFee;
+    /**
+     * How far the listing got through vAPI review. Reads as `none` for a registry
+     * that predates the tier, and for every mirrored external row.
+     */
+    verification: ListingVerification;
+    /** Seven days of the registry's hourly re-probe; absent when it sends none. */
+    liveness?: ListingLiveness;
+    /** How closely the listing's 402 follows its declared x402 version. */
+    conformance?: ListingConformance;
+    /** ERC-8004 agent identity on Base, when the registry has read one. */
+    identity?: ListingIdentity;
     payment: DiscoveryEndpoint["payment"] | null;
 };
 export declare function inspectService(input: InspectToolInput, config: VapiConfig, fetchImpl?: typeof fetch): Promise<InspectToolResult>;

package/dist/tools/router.d.ts

@@ -0,0 +1,135 @@
+import type { SecretStore, VapiConfig, VapiPaymentAccount, WalletStore } from "@vapi-network/core";
+import { buyRouterBalance, listRouterModels, ownerStake, routerChat, routerUsage } from "@vapi-network/core/router-client";
+import { z } from "zod";
+import type { WalletSession } from "../wallet-session.js";
+declare const routerChatInputSchema: z.ZodObject<{
+    wallet: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            system: "system";
+            user: "user";
+            assistant: "assistant";
+        }>;
+        content: z.ZodString;
+    }, z.core.$strict>>;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const routerBuyInputSchema: z.ZodObject<{
+    wallet: z.ZodOptional<z.ZodString>;
+    usd: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<5>, z.ZodLiteral<20>, z.ZodLiteral<50>]>;
+}, z.core.$strict>;
+export declare const routerModelsTool: {
+    description: string;
+    inputSchema: {};
+    outputSchema: z.ZodObject<{
+        models: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+};
+export declare const routerUsageTool: {
+    description: string;
+    inputSchema: {
+        wallet: z.ZodOptional<z.ZodString>;
+    };
+    outputSchema: z.ZodObject<{
+        stake: z.ZodObject<{
+            owner: z.ZodString;
+            stake: z.ZodString;
+            computeTodayUsd: z.ZodNumber;
+        }, z.core.$strip>;
+        compute: z.ZodObject<{
+            allowanceUsd: z.ZodNumber;
+            spentTodayUsd: z.ZodNumber;
+            remainingTodayUsd: z.ZodNumber;
+            resetsAt: z.ZodString;
+            ownerLimitUsd: z.ZodNumber;
+            ownerSpentUsd: z.ZodNumber;
+        }, z.core.$strip>;
+        balance: z.ZodNullable<z.ZodObject<{
+            purchasedUsd: z.ZodNumber;
+            spentUsd: z.ZodNumber;
+            remainingUsd: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+export declare const routerChatTool: {
+    description: string;
+    inputSchema: {
+        wallet: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                system: "system";
+                user: "user";
+                assistant: "assistant";
+            }>;
+            content: z.ZodString;
+        }, z.core.$strict>>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+    };
+    strictInput: boolean;
+    outputSchema: z.ZodObject<{
+        content: z.ZodNullable<z.ZodString>;
+        model: z.ZodString;
+        usage: z.ZodOptional<z.ZodObject<{
+            prompt_tokens: z.ZodNumber;
+            completion_tokens: z.ZodNumber;
+            total_tokens: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+export declare const routerBuyTool: {
+    description: string;
+    inputSchema: {
+        wallet: z.ZodOptional<z.ZodString>;
+        usd: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<5>, z.ZodLiteral<20>, z.ZodLiteral<50>]>;
+    };
+    strictInput: boolean;
+    outputSchema: z.ZodObject<{
+        receipt: z.ZodObject<{
+            id: z.ZodString;
+            amountUsd: z.ZodNumber;
+            network: z.ZodString;
+            transaction: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        balance: z.ZodNullable<z.ZodObject<{
+            purchasedUsd: z.ZodNumber;
+            spentUsd: z.ZodNumber;
+            remainingUsd: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+};
+export type RouterCoreOverrides = {
+    listRouterModels?: typeof listRouterModels | undefined;
+    routerUsage?: typeof routerUsage | undefined;
+    routerChat?: typeof routerChat | undefined;
+    ownerStake?: typeof ownerStake | undefined;
+    buyRouterBalance?: typeof buyRouterBalance | undefined;
+};
+export type RouterToolsOptions = RouterCoreOverrides & {
+    session: WalletSession;
+    secrets: SecretStore;
+    wallets?: WalletStore | undefined;
+    fetchImpl: typeof fetch;
+    apiBase: string;
+    account: VapiPaymentAccount;
+    config: VapiConfig;
+    ledgerPath?: string | undefined;
+    receiptsPath?: string | undefined;
+};
+type ToolResult = {
+    structuredContent: Record<string, unknown>;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare function createRouterTools(options: RouterToolsOptions): {
+    models(input: Record<string, never>): Promise<ToolResult>;
+    usage(input: {
+        wallet?: string;
+    }): Promise<ToolResult>;
+    chat(input: z.infer<typeof routerChatInputSchema>): Promise<ToolResult>;
+    buy(input: z.infer<typeof routerBuyInputSchema>): Promise<ToolResult>;
+};
+export {};

package/dist/x402.d.ts

@@ -13,7 +13,9 @@ export declare function buildX402Payment(args: {
     nowSeconds?: number;
     nonce?: Hex;
     fetchImpl?: typeof fetch;
+    paymentId?: string;
 }): Promise<{
     payload: X402PaymentPayload;
     headers: X402PaymentHeaders;
+    paymentId?: string;
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vapi-network/mcp",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Local, non-custodial MCP server for discovering and paying x402 APIs",
   "license": "Apache-2.0",
   "repository": {