@mixrpay/agent-sdk 0.8.5 → 0.8.7

package/README.md

@@ -2,15 +2,71 @@
 
 Enable AI agents to make payments to MixrPay-powered APIs.
 
+## Getting Started: Claim an Access Code
+
+Agents get spending authorization by claiming an **Access Code** from a human wallet owner.
+
+### Step 1: Human Creates Access Code
+
+The human logs in at [mixrpay.com/manage/invites](https://www.mixrpay.com/manage/invites), deposits funds, and creates an Access Code (e.g., `mixr-abc123`) with a budget.
+
+### Step 2: Agent Claims the Access Code
+
+```typescript
+import { AgentWallet } from '@mixrpay/agent-sdk';
+
+// Claim the Access Code to get your session key
+const result = await AgentWallet.claimInvite({
+  inviteCode: 'mixr-abc123',              // From the human
+  privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
+});
+
+// IMPORTANT: Save this immediately — shown ONCE, cannot be recovered!
+console.log('Session Key:', result.sessionKey);  // sk_live_xxx
+console.log('Budget:', result.limits.budgetUsd);
+console.log('Invited by:', result.inviterName);
+```
+
+### Step 3: Use the Session Key
+
+```typescript
+const wallet = new AgentWallet({
+  sessionKey: result.sessionKey,  // or process.env.MIXRPAY_SESSION_KEY
+});
+
+// All spending is authorized from the human's wallet
+const response = await wallet.fetch('https://api.example.com/paid-endpoint');
+```
+
+## Understanding Wallet Addresses
+
+When you claim an Access Code, two addresses are involved:
+
+| Address | What it is | Purpose |
+|---------|-----------|---------|
+| `info.address` | Session key's derived address | Used for signing requests |
+| `info.walletAddress` | Human's funded wallet | Where funds are charged FROM |
+
+**Verify which wallet you're spending from:**
+
+```typescript
+const info = await wallet.getSessionKeyInfo();
+console.log('Session key:', info.address);        // Your signing key
+console.log('Spending from:', info.walletAddress); // Human's wallet (funding source)
+console.log('Budget remaining:', info.limits.totalUsd);
+```
+
+This is important: your session key authorizes spending from the **human's wallet**, not your own external wallet. The human controls the budget and can revoke access at any time.
+
 ## Important: Session Key Security
 
 Your session key (`sk_live_...`) is a **private key**. Treat it like a password:
 
-- **Save it immediately** when you receive it (from `claimInvite()` or dashboard)
+- **Save it immediately** when you receive it (from `claimInvite()`)
 - **Store it securely** (environment variable, secrets manager)
 - **Never commit it** to version control
 - **Never log it** to console or files
-- **It cannot be recovered** if lost - you will need a new invite
+- **It cannot be recovered** if lost - you will need a new Access Code
 
 The session key is shown **only once** when claimed. MixrPay does not store it.
 
@@ -39,8 +95,6 @@ const response = await wallet.callMerchantApi({
 const data = await response.json();
 ```
 
-Get session keys at [mixrpay.com/wallet/sessions](https://www.mixrpay.com/wallet/sessions).
-
 ## Core Methods
 
 ```typescript

package/dist/index.cjs

@@ -100,7 +100,7 @@ var InsufficientBalanceError = class extends MixrPayError {
     this.name = "InsufficientBalanceError";
     this.required = required;
     this.available = available;
-    this.topUpUrl = "/wallet";
+    this.topUpUrl = "https://mixrpay.com/manage/wallet";
   }
 };
 var SessionKeyExpiredError = class extends MixrPayError {
@@ -108,7 +108,7 @@ var SessionKeyExpiredError = class extends MixrPayError {
   expiredAt;
   constructor(expiredAt) {
     super(
-      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner or create one at your MixrPay server /wallet/sessions`,
+      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner at https://mixrpay.com/manage/invites`,
       "SESSION_KEY_EXPIRED"
     );
     this.name = "SessionKeyExpiredError";
@@ -177,7 +177,7 @@ var InvalidSessionKeyError = class extends MixrPayError {
   reason;
   constructor(reason = "Invalid session key format") {
     super(
-      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from your MixrPay server /wallet/sessions`,
+      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from https://mixrpay.com/manage/invites`,
       "INVALID_SESSION_KEY"
     );
     this.name = "InvalidSessionKeyError";
@@ -532,7 +532,7 @@ function getAmountUsd(requirements) {
 }
 
 // src/agent-wallet.ts
-var SDK_VERSION = "0.8.5";
+var SDK_VERSION = "0.8.7";
 var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
 var DEFAULT_TIMEOUT = 3e4;
 var NETWORKS = {
@@ -648,7 +648,7 @@ var AgentWallet = class {
   validateConfig(config) {
     if (!config.sessionKey) {
       throw new InvalidSessionKeyError(
-        "Session key is required. Get one from the wallet owner or create one at your MixrPay server /wallet/sessions"
+        "Session key is required. Get one from the wallet owner at https://mixrpay.com/manage/invites"
       );
     }
     const key = config.sessionKey.trim();
@@ -1161,7 +1161,7 @@ var AgentWallet = class {
    * 
    * @example
    * ```typescript
-   * // Human creates invite at their dashboard, shares code "mixr-abc123"
+   * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
    * 
    * const result = await AgentWallet.claimInvite({
    *   inviteCode: 'mixr-abc123',
@@ -1387,6 +1387,16 @@ var AgentWallet = class {
     const data = await response.json();
     return data.children || [];
   }
+  /**
+   * List child sessions spawned by this agent.
+   * 
+   * Alias for `getChildSessions()` for naming consistency.
+   * 
+   * @returns Array of child session info
+   */
+  async listChildSessions() {
+    return this.getChildSessions();
+  }
   // ===========================================================================
   // Core Methods
   // ===========================================================================
@@ -1697,6 +1707,7 @@ var AgentWallet = class {
         const data = await response.json();
         this.sessionKeyInfo = {
           address: this.sessionKey.address,
+          walletAddress: data.wallet_address ?? data.walletAddress ?? null,
           isValid: data.is_valid ?? data.isValid ?? true,
           limits: {
             perTxUsd: data.per_tx_limit_usd ?? data.perTxLimitUsd ?? null,
@@ -1721,6 +1732,7 @@ var AgentWallet = class {
     }
     return {
       address: this.sessionKey.address,
+      walletAddress: null,
       isValid: true,
       limits: { perTxUsd: null, dailyUsd: null, totalUsd: null },
       usage: { todayUsd: this.totalSpentUsd, totalUsd: this.totalSpentUsd, txCount: this.payments.length },
@@ -1840,7 +1852,7 @@ var AgentWallet = class {
       checks.sessionKeyValid = info.isValid;
       if (!info.isValid) {
         issues.push("Session key is invalid or has been revoked.");
-        recommendations.push("Request a new session key from the wallet owner or create one at /wallet/sessions.");
+        recommendations.push("Request a new session key from the wallet owner at https://mixrpay.com/manage/invites");
       }
       const now = /* @__PURE__ */ new Date();
       let expiresInHours = null;
@@ -1880,7 +1892,7 @@ var AgentWallet = class {
       balance = await this.getBalance();
       checks.hasBalance = balance > 0;
       if (balance <= 0) {
-        issues.push("Wallet has no USDC balance. Top up at your MixrPay server /wallet");
+        issues.push("Wallet has no USDC balance. Top up at https://mixrpay.com/manage/wallet");
         recommendations.push("Deposit USDC to your wallet address to enable payments.");
       } else if (balance < 1) {
         issues.push(`Low balance: $${balance.toFixed(2)}. Consider topping up.`);
@@ -2683,6 +2695,141 @@ Timestamp: ${timestamp}`;
       createdAt: new Date(data.created_at)
     };
   }
+  /**
+   * Get details of a specific JIT MCP server instance.
+   * 
+   * @param instanceId - The instance ID to retrieve
+   * @returns Full instance details including endpoint URL
+   * 
+   * @example
+   * ```typescript
+   * const instance = await wallet.getJitInstance('inst_abc123');
+   * console.log('Endpoint:', instance.endpointUrl);
+   * console.log('Expires:', instance.expiresAt);
+   * ```
+   */
+  async getJitInstance(instanceId) {
+    this.logger.debug("getJitInstance", { instanceId });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(
+      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
+      { headers: authHeaders }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get JIT instance: ${response.status}`);
+    }
+    const data = await response.json();
+    return this.parseJitInstance(data.instance);
+  }
+  // ===========================================================================
+  // Glama MCP Directory Methods
+  // ===========================================================================
+  /**
+   * Search the Glama MCP server directory.
+   * 
+   * Glama indexes 15,000+ MCP servers. Use this to discover tools
+   * that can be deployed as JIT servers.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @param query - Search query (e.g., "notion", "github", "database")
+   * @returns Array of matching servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const results = await wallet.searchGlamaDirectory('notion');
+   * 
+   * // Filter to only hostable servers
+   * const hostable = results.servers.filter(s => s.canHost);
+   * console.log(`Found ${hostable.length} deployable servers`);
+   * 
+   * // Deploy one
+   * if (hostable.length > 0) {
+   *   const server = hostable[0];
+   *   await wallet.deployJitMcp({
+   *     glamaId: server.id,
+   *     glamaNamespace: server.namespace,
+   *     glamaSlug: server.slug,
+   *     toolName: server.name,
+   *     envVars: { API_KEY: '...' },
+   *   });
+   * }
+   * ```
+   */
+  async searchGlamaDirectory(query) {
+    this.logger.debug("searchGlamaDirectory", { query });
+    const params = new URLSearchParams({ q: query });
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama?${params}`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Glama search failed: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      pageInfo: data.pageInfo,
+      query: data.query
+    };
+  }
+  /**
+   * Get featured/popular MCP servers from the Glama directory.
+   * 
+   * Returns curated list of popular servers when you don't have
+   * a specific search query.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @returns Array of featured servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const { servers } = await wallet.getFeaturedGlamaServers();
+   * console.log('Featured servers:', servers.map(s => s.name));
+   * ```
+   */
+  async getFeaturedGlamaServers() {
+    this.logger.debug("getFeaturedGlamaServers");
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get featured servers: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      featured: data.featured
+    };
+  }
+  /**
+   * Parse Glama server response data.
+   */
+  parseGlamaServer(data) {
+    const importData = data.importData;
+    return {
+      id: data.id,
+      name: data.name,
+      namespace: data.namespace,
+      slug: data.slug,
+      description: data.description,
+      url: data.url,
+      attributes: data.attributes,
+      canHost: data.canHost,
+      tools: data.tools || [],
+      repository: data.repository,
+      license: data.spdxLicense?.name,
+      importData: importData ? {
+        glamaId: importData.glamaId,
+        glamaNamespace: importData.glamaNamespace,
+        glamaSlug: importData.glamaSlug,
+        suggestedName: importData.suggestedName,
+        suggestedDescription: importData.suggestedDescription,
+        hostingType: importData.hostingType,
+        requiredEnvVars: importData.requiredEnvVars,
+        optionalEnvVars: importData.optionalEnvVars
+      } : void 0
+    };
+  }
   // ===========================================================================
   // LLM Completion Methods
   // ===========================================================================

package/dist/index.d.cts

@@ -31,9 +31,8 @@ interface AgentWalletConfig {
      * Format: `sk_live_` (mainnet) or `sk_test_` (testnet) followed by 64 hex characters.
      *
      * Get session keys from:
-     * - The wallet owner's MixrPay dashboard
+     * - The wallet owner at https://mixrpay.com/manage/invites
      * - Programmatically via the MixrPay API
-     * - The MixrPay widget session key management
      *
      * @example 'sk_live_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
      */
@@ -130,8 +129,14 @@ interface PaymentEvent {
  * Information about a session key.
  */
 interface SessionKeyInfo {
-    /** The session key's address (derived public key) */
+    /** The session key's derived address (used for signing requests) */
     address: string;
+    /**
+     * The wallet address this session key is authorized to spend from.
+     * This is the human's funded wallet, NOT your agent's external wallet.
+     * All charges are deducted from this wallet.
+     */
+    walletAddress: string | null;
     /** Whether the session key is currently valid */
     isValid: boolean;
     /** Spending limits configured for this session key */
@@ -380,7 +385,7 @@ interface SessionStats {
  */
 
 /** Current SDK version */
-declare const SDK_VERSION = "0.8.5";
+declare const SDK_VERSION = "0.8.7";
 /** Supported networks */
 declare const NETWORKS: {
     readonly BASE_MAINNET: {
@@ -890,7 +895,7 @@ declare class AgentWallet {
      *
      * @example
      * ```typescript
-     * // Human creates invite at their dashboard, shares code "mixr-abc123"
+     * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
      *
      * const result = await AgentWallet.claimInvite({
      *   inviteCode: 'mixr-abc123',
@@ -983,6 +988,14 @@ declare class AgentWallet {
      * ```
      */
     getChildSessions(): Promise<ChildSession[]>;
+    /**
+     * List child sessions spawned by this agent.
+     *
+     * Alias for `getChildSessions()` for naming consistency.
+     *
+     * @returns Array of child session info
+     */
+    listChildSessions(): Promise<ChildSession[]>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *
@@ -1432,6 +1445,74 @@ declare class AgentWallet {
      * Parse JIT instance response data.
      */
     private parseJitInstance;
+    /**
+     * Get details of a specific JIT MCP server instance.
+     *
+     * @param instanceId - The instance ID to retrieve
+     * @returns Full instance details including endpoint URL
+     *
+     * @example
+     * ```typescript
+     * const instance = await wallet.getJitInstance('inst_abc123');
+     * console.log('Endpoint:', instance.endpointUrl);
+     * console.log('Expires:', instance.expiresAt);
+     * ```
+     */
+    getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * Search the Glama MCP server directory.
+     *
+     * Glama indexes 15,000+ MCP servers. Use this to discover tools
+     * that can be deployed as JIT servers.
+     *
+     * Note: This is a public API and does not require authentication.
+     *
+     * @param query - Search query (e.g., "notion", "github", "database")
+     * @returns Array of matching servers with hosting info
+     *
+     * @example
+     * ```typescript
+     * const results = await wallet.searchGlamaDirectory('notion');
+     *
+     * // Filter to only hostable servers
+     * const hostable = results.servers.filter(s => s.canHost);
+     * console.log(`Found ${hostable.length} deployable servers`);
+     *
+     * // Deploy one
+     * if (hostable.length > 0) {
+     *   const server = hostable[0];
+     *   await wallet.deployJitMcp({
+     *     glamaId: server.id,
+     *     glamaNamespace: server.namespace,
+     *     glamaSlug: server.slug,
+     *     toolName: server.name,
+     *     envVars: { API_KEY: '...' },
+     *   });
+     * }
+     * ```
+     */
+    searchGlamaDirectory(query: string): Promise<GlamaSearchResult>;
+    /**
+     * Get featured/popular MCP servers from the Glama directory.
+     *
+     * Returns curated list of popular servers when you don't have
+     * a specific search query.
+     *
+     * Note: This is a public API and does not require authentication.
+     *
+     * @returns Array of featured servers with hosting info
+     *
+     * @example
+     * ```typescript
+     * const { servers } = await wallet.getFeaturedGlamaServers();
+     * console.log('Featured servers:', servers.map(s => s.name));
+     * ```
+     */
+    getFeaturedGlamaServers(): Promise<GlamaSearchResult>;
+    /**
+     * Parse Glama server response data.
+     */
+    private parseGlamaServer;
     /**
      * Simple LLM completion - single-turn, no tools.
      *
@@ -2228,6 +2309,77 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * MCP server from the Glama directory
+ */
+interface GlamaServer {
+    /** Glama server ID */
+    id: string;
+    /** Server name */
+    name: string;
+    /** Namespace (e.g., "anthropics", "notion") */
+    namespace: string;
+    /** URL slug */
+    slug: string;
+    /** Server description */
+    description: string;
+    /** Glama URL */
+    url: string;
+    /** Server attributes (e.g., ["hosting:remote-capable", "author:official"]) */
+    attributes: string[];
+    /** Whether this server can be hosted as a JIT instance */
+    canHost: boolean;
+    /** Available tools */
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Repository info */
+    repository?: {
+        url: string;
+    };
+    /** License name */
+    license?: string;
+    /** Import data for deploying as JIT server */
+    importData?: GlamaImportData;
+}
+/**
+ * Import data for deploying a Glama server as JIT
+ */
+interface GlamaImportData {
+    /** Glama server ID */
+    glamaId: string;
+    /** Namespace */
+    glamaNamespace: string;
+    /** Slug */
+    glamaSlug: string;
+    /** Suggested display name */
+    suggestedName: string;
+    /** Suggested description */
+    suggestedDescription: string;
+    /** Hosting type */
+    hostingType: 'local' | 'remote' | 'hybrid';
+    /** Required environment variables (API keys) */
+    requiredEnvVars: string[];
+    /** Optional environment variables */
+    optionalEnvVars: string[];
+}
+/**
+ * Result from searching the Glama directory
+ */
+interface GlamaSearchResult {
+    /** Matching servers */
+    servers: GlamaServer[];
+    /** Pagination info */
+    pageInfo?: {
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    /** Original query (for search results) */
+    query?: string;
+    /** Whether these are featured servers */
+    featured?: boolean;
+}
 /**
  * Options for simple LLM completion
  */
@@ -2618,7 +2770,7 @@ declare class PaymentFailedError extends MixrPayError {
  * catch (error) {
  *   if (error instanceof InvalidSessionKeyError) {
  *     console.log(`Invalid key: ${error.reason}`);
- *     console.log('Get a valid session key from your MixrPay server /wallet/sessions');
+ *     console.log('Get a valid session key from https://mixrpay.com/manage/invites');
  *   }
  * }
  * ```
@@ -2836,4 +2988,4 @@ declare function isMixrPayError(error: unknown): error is MixrPayError;
  */
 declare function getErrorMessage(error: unknown): string;
 
-export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };
+export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, type GlamaImportData, type GlamaSearchResult, type GlamaServer, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.d.ts

@@ -31,9 +31,8 @@ interface AgentWalletConfig {
      * Format: `sk_live_` (mainnet) or `sk_test_` (testnet) followed by 64 hex characters.
      *
      * Get session keys from:
-     * - The wallet owner's MixrPay dashboard
+     * - The wallet owner at https://mixrpay.com/manage/invites
      * - Programmatically via the MixrPay API
-     * - The MixrPay widget session key management
      *
      * @example 'sk_live_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef'
      */
@@ -130,8 +129,14 @@ interface PaymentEvent {
  * Information about a session key.
  */
 interface SessionKeyInfo {
-    /** The session key's address (derived public key) */
+    /** The session key's derived address (used for signing requests) */
     address: string;
+    /**
+     * The wallet address this session key is authorized to spend from.
+     * This is the human's funded wallet, NOT your agent's external wallet.
+     * All charges are deducted from this wallet.
+     */
+    walletAddress: string | null;
     /** Whether the session key is currently valid */
     isValid: boolean;
     /** Spending limits configured for this session key */
@@ -380,7 +385,7 @@ interface SessionStats {
  */
 
 /** Current SDK version */
-declare const SDK_VERSION = "0.8.5";
+declare const SDK_VERSION = "0.8.7";
 /** Supported networks */
 declare const NETWORKS: {
     readonly BASE_MAINNET: {
@@ -890,7 +895,7 @@ declare class AgentWallet {
      *
      * @example
      * ```typescript
-     * // Human creates invite at their dashboard, shares code "mixr-abc123"
+     * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
      *
      * const result = await AgentWallet.claimInvite({
      *   inviteCode: 'mixr-abc123',
@@ -983,6 +988,14 @@ declare class AgentWallet {
      * ```
      */
     getChildSessions(): Promise<ChildSession[]>;
+    /**
+     * List child sessions spawned by this agent.
+     *
+     * Alias for `getChildSessions()` for naming consistency.
+     *
+     * @returns Array of child session info
+     */
+    listChildSessions(): Promise<ChildSession[]>;
     /**
      * Make an HTTP request, automatically handling x402 payment if required.
      *
@@ -1432,6 +1445,74 @@ declare class AgentWallet {
      * Parse JIT instance response data.
      */
     private parseJitInstance;
+    /**
+     * Get details of a specific JIT MCP server instance.
+     *
+     * @param instanceId - The instance ID to retrieve
+     * @returns Full instance details including endpoint URL
+     *
+     * @example
+     * ```typescript
+     * const instance = await wallet.getJitInstance('inst_abc123');
+     * console.log('Endpoint:', instance.endpointUrl);
+     * console.log('Expires:', instance.expiresAt);
+     * ```
+     */
+    getJitInstance(instanceId: string): Promise<JitInstance>;
+    /**
+     * Search the Glama MCP server directory.
+     *
+     * Glama indexes 15,000+ MCP servers. Use this to discover tools
+     * that can be deployed as JIT servers.
+     *
+     * Note: This is a public API and does not require authentication.
+     *
+     * @param query - Search query (e.g., "notion", "github", "database")
+     * @returns Array of matching servers with hosting info
+     *
+     * @example
+     * ```typescript
+     * const results = await wallet.searchGlamaDirectory('notion');
+     *
+     * // Filter to only hostable servers
+     * const hostable = results.servers.filter(s => s.canHost);
+     * console.log(`Found ${hostable.length} deployable servers`);
+     *
+     * // Deploy one
+     * if (hostable.length > 0) {
+     *   const server = hostable[0];
+     *   await wallet.deployJitMcp({
+     *     glamaId: server.id,
+     *     glamaNamespace: server.namespace,
+     *     glamaSlug: server.slug,
+     *     toolName: server.name,
+     *     envVars: { API_KEY: '...' },
+     *   });
+     * }
+     * ```
+     */
+    searchGlamaDirectory(query: string): Promise<GlamaSearchResult>;
+    /**
+     * Get featured/popular MCP servers from the Glama directory.
+     *
+     * Returns curated list of popular servers when you don't have
+     * a specific search query.
+     *
+     * Note: This is a public API and does not require authentication.
+     *
+     * @returns Array of featured servers with hosting info
+     *
+     * @example
+     * ```typescript
+     * const { servers } = await wallet.getFeaturedGlamaServers();
+     * console.log('Featured servers:', servers.map(s => s.name));
+     * ```
+     */
+    getFeaturedGlamaServers(): Promise<GlamaSearchResult>;
+    /**
+     * Parse Glama server response data.
+     */
+    private parseGlamaServer;
     /**
      * Simple LLM completion - single-turn, no tools.
      *
@@ -2228,6 +2309,77 @@ interface JitInstance {
     /** Creation time */
     createdAt: Date;
 }
+/**
+ * MCP server from the Glama directory
+ */
+interface GlamaServer {
+    /** Glama server ID */
+    id: string;
+    /** Server name */
+    name: string;
+    /** Namespace (e.g., "anthropics", "notion") */
+    namespace: string;
+    /** URL slug */
+    slug: string;
+    /** Server description */
+    description: string;
+    /** Glama URL */
+    url: string;
+    /** Server attributes (e.g., ["hosting:remote-capable", "author:official"]) */
+    attributes: string[];
+    /** Whether this server can be hosted as a JIT instance */
+    canHost: boolean;
+    /** Available tools */
+    tools: Array<{
+        name: string;
+        description?: string;
+    }>;
+    /** Repository info */
+    repository?: {
+        url: string;
+    };
+    /** License name */
+    license?: string;
+    /** Import data for deploying as JIT server */
+    importData?: GlamaImportData;
+}
+/**
+ * Import data for deploying a Glama server as JIT
+ */
+interface GlamaImportData {
+    /** Glama server ID */
+    glamaId: string;
+    /** Namespace */
+    glamaNamespace: string;
+    /** Slug */
+    glamaSlug: string;
+    /** Suggested display name */
+    suggestedName: string;
+    /** Suggested description */
+    suggestedDescription: string;
+    /** Hosting type */
+    hostingType: 'local' | 'remote' | 'hybrid';
+    /** Required environment variables (API keys) */
+    requiredEnvVars: string[];
+    /** Optional environment variables */
+    optionalEnvVars: string[];
+}
+/**
+ * Result from searching the Glama directory
+ */
+interface GlamaSearchResult {
+    /** Matching servers */
+    servers: GlamaServer[];
+    /** Pagination info */
+    pageInfo?: {
+        hasNextPage: boolean;
+        endCursor?: string;
+    };
+    /** Original query (for search results) */
+    query?: string;
+    /** Whether these are featured servers */
+    featured?: boolean;
+}
 /**
  * Options for simple LLM completion
  */
@@ -2618,7 +2770,7 @@ declare class PaymentFailedError extends MixrPayError {
  * catch (error) {
  *   if (error instanceof InvalidSessionKeyError) {
  *     console.log(`Invalid key: ${error.reason}`);
- *     console.log('Get a valid session key from your MixrPay server /wallet/sessions');
+ *     console.log('Get a valid session key from https://mixrpay.com/manage/invites');
  *   }
  * }
  * ```
@@ -2836,4 +2988,4 @@ declare function isMixrPayError(error: unknown): error is MixrPayError;
  */
 declare function getErrorMessage(error: unknown): string;
 
-export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };
+export { type AgentClaimInviteOptions, type AgentClaimInviteResult, type AgentMessage, type AgentRunConfig, type AgentRunEvent, type AgentRunOptions, type AgentRunResult, type AgentRunStatusResult, AgentWallet, type AgentWalletConfig, type AvailableBudget, type CallMerchantApiOptions, type ChargeResult, type ChildSession, type CompleteOptions, type CompleteResult, type DeployJitMcpOptions, type DeployJitMcpResult, type DiagnosticsResult, type GlamaImportData, type GlamaSearchResult, type GlamaServer, InsufficientBalanceError, InvalidSessionKeyError, type JitInstance, MerchantNotAllowedError, MixrPayError, type PaymentEvent, PaymentFailedError, SDK_VERSION, type SessionAuthorization, SessionExpiredError, SessionKeyExpiredError, type SessionKeyInfo, SessionLimitExceededError, SessionNotFoundError, SessionRevokedError, type SessionStats, type SpawnChildOptions, type SpawnChildResult, SpendingLimitExceededError, type SpendingStats, X402ProtocolError, getErrorMessage, isMixrPayError };

package/dist/index.js

@@ -63,7 +63,7 @@ var InsufficientBalanceError = class extends MixrPayError {
     this.name = "InsufficientBalanceError";
     this.required = required;
     this.available = available;
-    this.topUpUrl = "/wallet";
+    this.topUpUrl = "https://mixrpay.com/manage/wallet";
   }
 };
 var SessionKeyExpiredError = class extends MixrPayError {
@@ -71,7 +71,7 @@ var SessionKeyExpiredError = class extends MixrPayError {
   expiredAt;
   constructor(expiredAt) {
     super(
-      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner or create one at your MixrPay server /wallet/sessions`,
+      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner at https://mixrpay.com/manage/invites`,
       "SESSION_KEY_EXPIRED"
     );
     this.name = "SessionKeyExpiredError";
@@ -140,7 +140,7 @@ var InvalidSessionKeyError = class extends MixrPayError {
   reason;
   constructor(reason = "Invalid session key format") {
     super(
-      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from your MixrPay server /wallet/sessions`,
+      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from https://mixrpay.com/manage/invites`,
       "INVALID_SESSION_KEY"
     );
     this.name = "InvalidSessionKeyError";
@@ -495,7 +495,7 @@ function getAmountUsd(requirements) {
 }
 
 // src/agent-wallet.ts
-var SDK_VERSION = "0.8.5";
+var SDK_VERSION = "0.8.7";
 var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
 var DEFAULT_TIMEOUT = 3e4;
 var NETWORKS = {
@@ -611,7 +611,7 @@ var AgentWallet = class {
   validateConfig(config) {
     if (!config.sessionKey) {
       throw new InvalidSessionKeyError(
-        "Session key is required. Get one from the wallet owner or create one at your MixrPay server /wallet/sessions"
+        "Session key is required. Get one from the wallet owner at https://mixrpay.com/manage/invites"
       );
     }
     const key = config.sessionKey.trim();
@@ -1124,7 +1124,7 @@ var AgentWallet = class {
    * 
    * @example
    * ```typescript
-   * // Human creates invite at their dashboard, shares code "mixr-abc123"
+   * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
    * 
    * const result = await AgentWallet.claimInvite({
    *   inviteCode: 'mixr-abc123',
@@ -1350,6 +1350,16 @@ var AgentWallet = class {
     const data = await response.json();
     return data.children || [];
   }
+  /**
+   * List child sessions spawned by this agent.
+   * 
+   * Alias for `getChildSessions()` for naming consistency.
+   * 
+   * @returns Array of child session info
+   */
+  async listChildSessions() {
+    return this.getChildSessions();
+  }
   // ===========================================================================
   // Core Methods
   // ===========================================================================
@@ -1660,6 +1670,7 @@ var AgentWallet = class {
         const data = await response.json();
         this.sessionKeyInfo = {
           address: this.sessionKey.address,
+          walletAddress: data.wallet_address ?? data.walletAddress ?? null,
           isValid: data.is_valid ?? data.isValid ?? true,
           limits: {
             perTxUsd: data.per_tx_limit_usd ?? data.perTxLimitUsd ?? null,
@@ -1684,6 +1695,7 @@ var AgentWallet = class {
     }
     return {
       address: this.sessionKey.address,
+      walletAddress: null,
       isValid: true,
       limits: { perTxUsd: null, dailyUsd: null, totalUsd: null },
       usage: { todayUsd: this.totalSpentUsd, totalUsd: this.totalSpentUsd, txCount: this.payments.length },
@@ -1803,7 +1815,7 @@ var AgentWallet = class {
       checks.sessionKeyValid = info.isValid;
       if (!info.isValid) {
         issues.push("Session key is invalid or has been revoked.");
-        recommendations.push("Request a new session key from the wallet owner or create one at /wallet/sessions.");
+        recommendations.push("Request a new session key from the wallet owner at https://mixrpay.com/manage/invites");
       }
       const now = /* @__PURE__ */ new Date();
       let expiresInHours = null;
@@ -1843,7 +1855,7 @@ var AgentWallet = class {
       balance = await this.getBalance();
       checks.hasBalance = balance > 0;
       if (balance <= 0) {
-        issues.push("Wallet has no USDC balance. Top up at your MixrPay server /wallet");
+        issues.push("Wallet has no USDC balance. Top up at https://mixrpay.com/manage/wallet");
         recommendations.push("Deposit USDC to your wallet address to enable payments.");
       } else if (balance < 1) {
         issues.push(`Low balance: $${balance.toFixed(2)}. Consider topping up.`);
@@ -2646,6 +2658,141 @@ Timestamp: ${timestamp}`;
       createdAt: new Date(data.created_at)
     };
   }
+  /**
+   * Get details of a specific JIT MCP server instance.
+   * 
+   * @param instanceId - The instance ID to retrieve
+   * @returns Full instance details including endpoint URL
+   * 
+   * @example
+   * ```typescript
+   * const instance = await wallet.getJitInstance('inst_abc123');
+   * console.log('Endpoint:', instance.endpointUrl);
+   * console.log('Expires:', instance.expiresAt);
+   * ```
+   */
+  async getJitInstance(instanceId) {
+    this.logger.debug("getJitInstance", { instanceId });
+    const authHeaders = await this.getSessionAuthHeaders();
+    const response = await fetch(
+      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
+      { headers: authHeaders }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get JIT instance: ${response.status}`);
+    }
+    const data = await response.json();
+    return this.parseJitInstance(data.instance);
+  }
+  // ===========================================================================
+  // Glama MCP Directory Methods
+  // ===========================================================================
+  /**
+   * Search the Glama MCP server directory.
+   * 
+   * Glama indexes 15,000+ MCP servers. Use this to discover tools
+   * that can be deployed as JIT servers.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @param query - Search query (e.g., "notion", "github", "database")
+   * @returns Array of matching servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const results = await wallet.searchGlamaDirectory('notion');
+   * 
+   * // Filter to only hostable servers
+   * const hostable = results.servers.filter(s => s.canHost);
+   * console.log(`Found ${hostable.length} deployable servers`);
+   * 
+   * // Deploy one
+   * if (hostable.length > 0) {
+   *   const server = hostable[0];
+   *   await wallet.deployJitMcp({
+   *     glamaId: server.id,
+   *     glamaNamespace: server.namespace,
+   *     glamaSlug: server.slug,
+   *     toolName: server.name,
+   *     envVars: { API_KEY: '...' },
+   *   });
+   * }
+   * ```
+   */
+  async searchGlamaDirectory(query) {
+    this.logger.debug("searchGlamaDirectory", { query });
+    const params = new URLSearchParams({ q: query });
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama?${params}`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Glama search failed: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      pageInfo: data.pageInfo,
+      query: data.query
+    };
+  }
+  /**
+   * Get featured/popular MCP servers from the Glama directory.
+   * 
+   * Returns curated list of popular servers when you don't have
+   * a specific search query.
+   * 
+   * Note: This is a public API and does not require authentication.
+   * 
+   * @returns Array of featured servers with hosting info
+   * 
+   * @example
+   * ```typescript
+   * const { servers } = await wallet.getFeaturedGlamaServers();
+   * console.log('Featured servers:', servers.map(s => s.name));
+   * ```
+   */
+  async getFeaturedGlamaServers() {
+    this.logger.debug("getFeaturedGlamaServers");
+    const response = await fetch(`${this.baseUrl}/api/mcp/glama`);
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new MixrPayError(error.error || `Failed to get featured servers: ${response.status}`);
+    }
+    const data = await response.json();
+    return {
+      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
+      featured: data.featured
+    };
+  }
+  /**
+   * Parse Glama server response data.
+   */
+  parseGlamaServer(data) {
+    const importData = data.importData;
+    return {
+      id: data.id,
+      name: data.name,
+      namespace: data.namespace,
+      slug: data.slug,
+      description: data.description,
+      url: data.url,
+      attributes: data.attributes,
+      canHost: data.canHost,
+      tools: data.tools || [],
+      repository: data.repository,
+      license: data.spdxLicense?.name,
+      importData: importData ? {
+        glamaId: importData.glamaId,
+        glamaNamespace: importData.glamaNamespace,
+        glamaSlug: importData.glamaSlug,
+        suggestedName: importData.suggestedName,
+        suggestedDescription: importData.suggestedDescription,
+        hostingType: importData.hostingType,
+        requiredEnvVars: importData.requiredEnvVars,
+        optionalEnvVars: importData.optionalEnvVars
+      } : void 0
+    };
+  }
   // ===========================================================================
   // LLM Completion Methods
   // ===========================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mixrpay/agent-sdk",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "MixrPay Agent SDK - Enable AI agents to make x402 payments with session keys",
   "type": "module",
   "main": "./dist/index.js",