@iqai/adk 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @iqai/adk
 
+## 0.1.2
+
+### Patch Changes
+
+- 17a5d3f: Fix MCP sampling
+- 0081ed9: Adds MCP simplified syntax for well known servers
+
 ## 0.1.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1431,6 +1431,174 @@ declare class McpSamplingHandler {
  */
 declare function createSamplingHandler(handler: SamplingHandler): SamplingHandler;
 
+/**
+ * Simplified MCP Server Wrappers
+ *
+ * This module provides simplified wrapper functions for IQAI MCP servers and popular third-party MCP servers.
+ * Instead of manually configuring McpToolset with verbose configuration objects, you can use these
+ * convenience functions with flexible configuration objects.
+ *
+ * @example
+ * ```typescript
+ * // Old verbose way:
+ * const toolset = new McpToolset({
+ *   name: "Near Intent Swaps MCP Client",
+ *   description: "Client for Near Intent Swaps",
+ *   debug: env.DEBUG,
+ *   retryOptions: { maxRetries: 2, initialDelay: 200 },
+ *   transport: {
+ *     mode: "stdio",
+ *     command: "npx",
+ *     args: ["-y", "@iqai/mcp-near"],
+ *     env: {
+ *       ACCOUNT_ID: env.ACCOUNT_ID,
+ *       ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *       NEAR_NETWORK_ID: "testnet",
+ *       PATH: env.PATH
+ *     },
+ *   },
+ * });
+ *
+ * // New simplified way:
+ * const toolset = McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   }
+ * });
+ *
+ * // Usage with LLM Agent:
+ * const nearTools = await toolset.getTools();
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multiple MCP servers:
+ * const atpTools = await McpAtp({
+ *   env: {
+ *     ATP_WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY,
+ *     ATP_API_KEY: env.ATP_API_KEY
+ *   }
+ * }).getTools();
+ *
+ * const fraxlendTools = await McpFraxlend({
+ *   env: {
+ *     WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY
+ *   }
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "defi_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: [...atpTools, ...fraxlendTools],
+ * });
+ * ```
+ */
+/**
+ * Base configuration interface for MCP servers
+ */
+interface McpServerConfig {
+    /** Environment variables to pass to the MCP server */
+    env?: Record<string, any>;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom description for the MCP server */
+    description?: string;
+    /** Retry configuration */
+    retryOptions?: {
+        maxRetries?: number;
+        initialDelay?: number;
+    };
+}
+/**
+ * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
+ *
+ * Required env vars: CONTRACT_ABI, CONTRACT_ADDRESS
+ * Optional env vars: CONTRACT_NAME, CHAIN_ID, RPC_URL, WALLET_PRIVATE_KEY
+ */
+declare function McpAbi(config: McpServerConfig): McpToolset;
+/**
+ * MCP ATP - Interact with the IQ AI Agent Tokenization Platform
+ *
+ * Required env vars: ATP_WALLET_PRIVATE_KEY, ATP_API_KEY
+ */
+declare function McpAtp(config: McpServerConfig): McpToolset;
+/**
+ * MCP BAMM - Borrow Automated Market Maker operations on Fraxtal
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpBamm(config: McpServerConfig): McpToolset;
+/**
+ * MCP FRAXLEND - Interact with the Fraxlend lending platform
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpFraxlend(config: McpServerConfig): McpToolset;
+/**
+ * MCP IQWiki - Access and manage IQ.wiki data and user activities
+ *
+ * No required env vars
+ */
+declare function McpIqWiki(config?: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Agent - NEAR Protocol blockchain integration with AI-driven event processing
+ *
+ * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
+ * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
+ */
+declare function McpNearAgent(config: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Intent Swaps - NEAR Protocol intent swaps functionality
+ *
+ * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
+ * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
+ */
+declare function McpNearIntentSwaps(config: McpServerConfig): McpToolset;
+/**
+ * MCP ODOS - Interact with decentralized exchanges through ODOS aggregation
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpOdos(config: McpServerConfig): McpToolset;
+/**
+ * MCP Telegram - Interact with Telegram bots and channels
+ *
+ * Required env vars: TELEGRAM_BOT_TOKEN
+ */
+declare function McpTelegram(config: McpServerConfig): McpToolset;
+/**
+ * Popular third-party MCP servers
+ * These can be added as we expand support for community MCP servers
+ */
+/**
+ * MCP Filesystem - File system operations (third-party)
+ *
+ * Optional env vars: ALLOWED_DIRECTORIES (comma-separated list)
+ */
+declare function McpFilesystem(config?: McpServerConfig): McpToolset;
+/**
+ * MCP Memory - Memory and note-taking capabilities (third-party)
+ *
+ * No required env vars
+ */
+declare function McpMemory(config?: McpServerConfig): McpToolset;
+/**
+ * Generic MCP server function for any package
+ *
+ * @param packageName The npm package name of the MCP server
+ * @param config Configuration object with environment variables
+ * @param name Optional custom name for the client
+ */
+declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;
+
 /**
  * A class for managing MCP tools similar to Python's MCPToolset.
  * Provides functionality to retrieve and use tools from an MCP server.
@@ -1520,15 +1688,28 @@ type index$6_LoadArtifactsTool = LoadArtifactsTool;
 declare const index$6_LoadArtifactsTool: typeof LoadArtifactsTool;
 type index$6_LoadMemoryTool = LoadMemoryTool;
 declare const index$6_LoadMemoryTool: typeof LoadMemoryTool;
+declare const index$6_McpAbi: typeof McpAbi;
+declare const index$6_McpAtp: typeof McpAtp;
+declare const index$6_McpBamm: typeof McpBamm;
 type index$6_McpConfig = McpConfig;
 type index$6_McpError = McpError;
 declare const index$6_McpError: typeof McpError;
 type index$6_McpErrorType = McpErrorType;
 declare const index$6_McpErrorType: typeof McpErrorType;
+declare const index$6_McpFilesystem: typeof McpFilesystem;
+declare const index$6_McpFraxlend: typeof McpFraxlend;
+declare const index$6_McpGeneric: typeof McpGeneric;
+declare const index$6_McpIqWiki: typeof McpIqWiki;
+declare const index$6_McpMemory: typeof McpMemory;
+declare const index$6_McpNearAgent: typeof McpNearAgent;
+declare const index$6_McpNearIntentSwaps: typeof McpNearIntentSwaps;
+declare const index$6_McpOdos: typeof McpOdos;
 type index$6_McpSamplingHandler = McpSamplingHandler;
 declare const index$6_McpSamplingHandler: typeof McpSamplingHandler;
 type index$6_McpSamplingRequest = McpSamplingRequest;
 type index$6_McpSamplingResponse = McpSamplingResponse;
+type index$6_McpServerConfig = McpServerConfig;
+declare const index$6_McpTelegram: typeof McpTelegram;
 type index$6_McpToolset = McpToolset;
 declare const index$6_McpToolset: typeof McpToolset;
 type index$6_McpTransportType = McpTransportType;
@@ -1549,7 +1730,7 @@ declare const index$6_jsonSchemaToDeclaration: typeof jsonSchemaToDeclaration;
 declare const index$6_mcpSchemaToParameters: typeof mcpSchemaToParameters;
 declare const index$6_normalizeJsonSchema: typeof normalizeJsonSchema;
 declare namespace index$6 {
-  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
+  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, index$6_McpAbi as McpAbi, index$6_McpAtp as McpAtp, index$6_McpBamm as McpBamm, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpFilesystem as McpFilesystem, index$6_McpFraxlend as McpFraxlend, index$6_McpGeneric as McpGeneric, index$6_McpIqWiki as McpIqWiki, index$6_McpMemory as McpMemory, index$6_McpNearAgent as McpNearAgent, index$6_McpNearIntentSwaps as McpNearIntentSwaps, index$6_McpOdos as McpOdos, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, type index$6_McpServerConfig as McpServerConfig, index$6_McpTelegram as McpTelegram, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
 }
 
 /**
@@ -4453,4 +4634,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInPlanner, CallbackContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, type McpConfig, McpError, McpErrorType, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInPlanner, CallbackContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, type McpConfig, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntentSwaps, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };

package/dist/index.d.ts

@@ -1431,6 +1431,174 @@ declare class McpSamplingHandler {
  */
 declare function createSamplingHandler(handler: SamplingHandler): SamplingHandler;
 
+/**
+ * Simplified MCP Server Wrappers
+ *
+ * This module provides simplified wrapper functions for IQAI MCP servers and popular third-party MCP servers.
+ * Instead of manually configuring McpToolset with verbose configuration objects, you can use these
+ * convenience functions with flexible configuration objects.
+ *
+ * @example
+ * ```typescript
+ * // Old verbose way:
+ * const toolset = new McpToolset({
+ *   name: "Near Intent Swaps MCP Client",
+ *   description: "Client for Near Intent Swaps",
+ *   debug: env.DEBUG,
+ *   retryOptions: { maxRetries: 2, initialDelay: 200 },
+ *   transport: {
+ *     mode: "stdio",
+ *     command: "npx",
+ *     args: ["-y", "@iqai/mcp-near"],
+ *     env: {
+ *       ACCOUNT_ID: env.ACCOUNT_ID,
+ *       ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *       NEAR_NETWORK_ID: "testnet",
+ *       PATH: env.PATH
+ *     },
+ *   },
+ * });
+ *
+ * // New simplified way:
+ * const toolset = McpNearAgent({
+ *   env: {
+ *     ACCOUNT_ID: env.ACCOUNT_ID,
+ *     ACCOUNT_KEY: env.ACCOUNT_KEY,
+ *     NEAR_NETWORK_ID: "testnet",
+ *     PATH: env.PATH
+ *   }
+ * });
+ *
+ * // Usage with LLM Agent:
+ * const nearTools = await toolset.getTools();
+ * const agent = new LlmAgent({
+ *   name: "near_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: nearTools,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multiple MCP servers:
+ * const atpTools = await McpAtp({
+ *   env: {
+ *     ATP_WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY,
+ *     ATP_API_KEY: env.ATP_API_KEY
+ *   }
+ * }).getTools();
+ *
+ * const fraxlendTools = await McpFraxlend({
+ *   env: {
+ *     WALLET_PRIVATE_KEY: env.WALLET_PRIVATE_KEY
+ *   }
+ * }).getTools();
+ *
+ * const agent = new LlmAgent({
+ *   name: "defi_assistant",
+ *   model: "gemini-2.5-flash",
+ *   tools: [...atpTools, ...fraxlendTools],
+ * });
+ * ```
+ */
+/**
+ * Base configuration interface for MCP servers
+ */
+interface McpServerConfig {
+    /** Environment variables to pass to the MCP server */
+    env?: Record<string, any>;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom description for the MCP server */
+    description?: string;
+    /** Retry configuration */
+    retryOptions?: {
+        maxRetries?: number;
+        initialDelay?: number;
+    };
+}
+/**
+ * MCP ABI - Smart contract ABI interactions for Ethereum-compatible blockchains
+ *
+ * Required env vars: CONTRACT_ABI, CONTRACT_ADDRESS
+ * Optional env vars: CONTRACT_NAME, CHAIN_ID, RPC_URL, WALLET_PRIVATE_KEY
+ */
+declare function McpAbi(config: McpServerConfig): McpToolset;
+/**
+ * MCP ATP - Interact with the IQ AI Agent Tokenization Platform
+ *
+ * Required env vars: ATP_WALLET_PRIVATE_KEY, ATP_API_KEY
+ */
+declare function McpAtp(config: McpServerConfig): McpToolset;
+/**
+ * MCP BAMM - Borrow Automated Market Maker operations on Fraxtal
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpBamm(config: McpServerConfig): McpToolset;
+/**
+ * MCP FRAXLEND - Interact with the Fraxlend lending platform
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpFraxlend(config: McpServerConfig): McpToolset;
+/**
+ * MCP IQWiki - Access and manage IQ.wiki data and user activities
+ *
+ * No required env vars
+ */
+declare function McpIqWiki(config?: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Agent - NEAR Protocol blockchain integration with AI-driven event processing
+ *
+ * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
+ * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
+ */
+declare function McpNearAgent(config: McpServerConfig): McpToolset;
+/**
+ * MCP NEAR Intent Swaps - NEAR Protocol intent swaps functionality
+ *
+ * Required env vars: ACCOUNT_ID, ACCOUNT_KEY
+ * Optional env vars: NEAR_NETWORK_ID, NEAR_NODE_URL, NEAR_GAS_LIMIT
+ */
+declare function McpNearIntentSwaps(config: McpServerConfig): McpToolset;
+/**
+ * MCP ODOS - Interact with decentralized exchanges through ODOS aggregation
+ *
+ * Required env vars: WALLET_PRIVATE_KEY
+ */
+declare function McpOdos(config: McpServerConfig): McpToolset;
+/**
+ * MCP Telegram - Interact with Telegram bots and channels
+ *
+ * Required env vars: TELEGRAM_BOT_TOKEN
+ */
+declare function McpTelegram(config: McpServerConfig): McpToolset;
+/**
+ * Popular third-party MCP servers
+ * These can be added as we expand support for community MCP servers
+ */
+/**
+ * MCP Filesystem - File system operations (third-party)
+ *
+ * Optional env vars: ALLOWED_DIRECTORIES (comma-separated list)
+ */
+declare function McpFilesystem(config?: McpServerConfig): McpToolset;
+/**
+ * MCP Memory - Memory and note-taking capabilities (third-party)
+ *
+ * No required env vars
+ */
+declare function McpMemory(config?: McpServerConfig): McpToolset;
+/**
+ * Generic MCP server function for any package
+ *
+ * @param packageName The npm package name of the MCP server
+ * @param config Configuration object with environment variables
+ * @param name Optional custom name for the client
+ */
+declare function McpGeneric(packageName: string, config?: McpServerConfig, name?: string): McpToolset;
+
 /**
  * A class for managing MCP tools similar to Python's MCPToolset.
  * Provides functionality to retrieve and use tools from an MCP server.
@@ -1520,15 +1688,28 @@ type index$6_LoadArtifactsTool = LoadArtifactsTool;
 declare const index$6_LoadArtifactsTool: typeof LoadArtifactsTool;
 type index$6_LoadMemoryTool = LoadMemoryTool;
 declare const index$6_LoadMemoryTool: typeof LoadMemoryTool;
+declare const index$6_McpAbi: typeof McpAbi;
+declare const index$6_McpAtp: typeof McpAtp;
+declare const index$6_McpBamm: typeof McpBamm;
 type index$6_McpConfig = McpConfig;
 type index$6_McpError = McpError;
 declare const index$6_McpError: typeof McpError;
 type index$6_McpErrorType = McpErrorType;
 declare const index$6_McpErrorType: typeof McpErrorType;
+declare const index$6_McpFilesystem: typeof McpFilesystem;
+declare const index$6_McpFraxlend: typeof McpFraxlend;
+declare const index$6_McpGeneric: typeof McpGeneric;
+declare const index$6_McpIqWiki: typeof McpIqWiki;
+declare const index$6_McpMemory: typeof McpMemory;
+declare const index$6_McpNearAgent: typeof McpNearAgent;
+declare const index$6_McpNearIntentSwaps: typeof McpNearIntentSwaps;
+declare const index$6_McpOdos: typeof McpOdos;
 type index$6_McpSamplingHandler = McpSamplingHandler;
 declare const index$6_McpSamplingHandler: typeof McpSamplingHandler;
 type index$6_McpSamplingRequest = McpSamplingRequest;
 type index$6_McpSamplingResponse = McpSamplingResponse;
+type index$6_McpServerConfig = McpServerConfig;
+declare const index$6_McpTelegram: typeof McpTelegram;
 type index$6_McpToolset = McpToolset;
 declare const index$6_McpToolset: typeof McpToolset;
 type index$6_McpTransportType = McpTransportType;
@@ -1549,7 +1730,7 @@ declare const index$6_jsonSchemaToDeclaration: typeof jsonSchemaToDeclaration;
 declare const index$6_mcpSchemaToParameters: typeof mcpSchemaToParameters;
 declare const index$6_normalizeJsonSchema: typeof normalizeJsonSchema;
 declare namespace index$6 {
-  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
+  export { index$6_BaseTool as BaseTool, type index$6_BuildFunctionDeclarationOptions as BuildFunctionDeclarationOptions, index$6_ExitLoopTool as ExitLoopTool, index$6_FileOperationsTool as FileOperationsTool, index$6_FunctionTool as FunctionTool, index$6_GetUserChoiceTool as GetUserChoiceTool, index$6_GoogleSearch as GoogleSearch, index$6_HttpRequestTool as HttpRequestTool, index$6_LoadArtifactsTool as LoadArtifactsTool, index$6_LoadMemoryTool as LoadMemoryTool, index$6_McpAbi as McpAbi, index$6_McpAtp as McpAtp, index$6_McpBamm as McpBamm, type index$6_McpConfig as McpConfig, index$6_McpError as McpError, index$6_McpErrorType as McpErrorType, index$6_McpFilesystem as McpFilesystem, index$6_McpFraxlend as McpFraxlend, index$6_McpGeneric as McpGeneric, index$6_McpIqWiki as McpIqWiki, index$6_McpMemory as McpMemory, index$6_McpNearAgent as McpNearAgent, index$6_McpNearIntentSwaps as McpNearIntentSwaps, index$6_McpOdos as McpOdos, index$6_McpSamplingHandler as McpSamplingHandler, type index$6_McpSamplingRequest as McpSamplingRequest, type index$6_McpSamplingResponse as McpSamplingResponse, type index$6_McpServerConfig as McpServerConfig, index$6_McpTelegram as McpTelegram, index$6_McpToolset as McpToolset, type index$6_McpTransportType as McpTransportType, type index$6_SamplingHandler as SamplingHandler, type index$6_ToolConfig as ToolConfig, index$6_ToolContext as ToolContext, index$6_TransferToAgentTool as TransferToAgentTool, index$6_UserInteractionTool as UserInteractionTool, index$6_adkToMcpToolType as adkToMcpToolType, index$6_buildFunctionDeclaration as buildFunctionDeclaration, index$6_createFunctionTool as createFunctionTool, index$6_createSamplingHandler as createSamplingHandler, index$6_getMcpTools as getMcpTools, index$6_jsonSchemaToDeclaration as jsonSchemaToDeclaration, index$6_mcpSchemaToParameters as mcpSchemaToParameters, index$6_normalizeJsonSchema as normalizeJsonSchema };
 }
 
 /**
@@ -4453,4 +4634,4 @@ declare const traceLlmCall: (invocationContext: InvocationContext, eventId: stri
 
 declare const VERSION = "0.1.0";
 
-export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInPlanner, CallbackContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, type McpConfig, McpError, McpErrorType, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };
+export { AF_FUNCTION_CALL_ID_PREFIX, type AfterAgentCallback, LlmAgent as Agent, AgentBuilder, type AgentBuilderConfig, type AgentType, index$4 as Agents, AnthropicLlm, ApiKeyCredential, ApiKeyScheme, AuthConfig, AuthCredential, AuthCredentialType, AuthHandler, AuthScheme, AuthSchemeType, AuthTool, type AuthToolArguments, AutoFlow, BaseAgent, BaseLLMConnection, BaseLlm, BaseLlmFlow, BaseLlmRequestProcessor, BaseLlmResponseProcessor, type BaseMemoryService, BasePlanner, BaseSessionService, BaseTool, BasicAuthCredential, BearerTokenCredential, type BeforeAgentCallback, type BuildFunctionDeclarationOptions, type BuiltAgent, BuiltInPlanner, CallbackContext, DatabaseSessionService, EnhancedAuthConfig, Event, EventActions, index$1 as Events, ExitLoopTool, FileOperationsTool, index as Flows, type FunctionDeclaration, FunctionTool, GcsArtifactService, type GetSessionConfig, GetUserChoiceTool, GoogleLlm, GoogleSearch, HttpRequestTool, HttpScheme, InMemoryArtifactService, InMemoryMemoryService, InMemoryRunner, InMemorySessionService, type InstructionProvider, InvocationContext, type JSONSchema, LLMRegistry, LangGraphAgent, type LangGraphAgentConfig, type LangGraphNode, type ListSessionsResponse, LlmAgent, type LlmAgentConfig, LlmCallsLimitExceededError, LlmRequest, LlmResponse, LoadArtifactsTool, LoadMemoryTool, LoopAgent, type LoopAgentConfig, McpAbi, McpAtp, McpBamm, type McpConfig, McpError, McpErrorType, McpFilesystem, McpFraxlend, McpGeneric, McpIqWiki, McpMemory, McpNearAgent, McpNearIntentSwaps, McpOdos, McpSamplingHandler, type McpSamplingRequest, type McpSamplingResponse, type McpServerConfig, McpTelegram, McpToolset, type McpTransportType, index$3 as Memory, index$5 as Models, OAuth2Credential, OAuth2Scheme, type OAuthFlow, type OAuthFlows, OpenAiLlm, OpenIdConnectScheme, ParallelAgent, type ParallelAgentConfig, PlanReActPlanner, REQUEST_EUC_FUNCTION_CALL_NAME, ReadonlyContext, RunConfig, Runner, type SamplingHandler, type SearchMemoryResponse, SequentialAgent, type SequentialAgentConfig, type Session, type SessionConfig, index$2 as Sessions, type SingleAgentCallback, SingleFlow, State, StreamingMode, type TelemetryConfig, TelemetryService, type ThinkingConfig, type ToolConfig, ToolContext, type ToolUnion, index$6 as Tools, TransferToAgentTool, UserInteractionTool, VERSION, VertexAiSessionService, adkToMcpToolType, requestProcessor$2 as agentTransferRequestProcessor, requestProcessor$6 as basicRequestProcessor, buildFunctionDeclaration, requestProcessor as codeExecutionRequestProcessor, responseProcessor as codeExecutionResponseProcessor, requestProcessor$3 as contentRequestProcessor, createAuthToolArguments, createDatabaseSessionService, createFunctionTool, createMysqlSessionService, createPostgresSessionService, createSamplingHandler, createSqliteSessionService, generateAuthEvent, generateClientFunctionCallId, getLongRunningFunctionCalls, getMcpTools, handleFunctionCallsAsync, handleFunctionCallsLive, requestProcessor$5 as identityRequestProcessor, initializeTelemetry, injectSessionState, requestProcessor$4 as instructionsRequestProcessor, isEnhancedAuthConfig, jsonSchemaToDeclaration, mcpSchemaToParameters, mergeParallelFunctionResponseEvents, newInvocationContextId, requestProcessor$1 as nlPlanningRequestProcessor, responseProcessor$1 as nlPlanningResponseProcessor, normalizeJsonSchema, populateClientFunctionCallId, registerProviders, removeClientFunctionCallId, requestProcessor$7 as requestProcessor, shutdownTelemetry, telemetryService, traceLlmCall, traceToolCall, tracer };

package/dist/index.js

@@ -3476,9 +3476,21 @@ __export(tools_exports, {
   HttpRequestTool: () => HttpRequestTool,
   LoadArtifactsTool: () => LoadArtifactsTool,
   LoadMemoryTool: () => LoadMemoryTool,
+  McpAbi: () => McpAbi,
+  McpAtp: () => McpAtp,
+  McpBamm: () => McpBamm,
   McpError: () => McpError,
   McpErrorType: () => McpErrorType,
+  McpFilesystem: () => McpFilesystem,
+  McpFraxlend: () => McpFraxlend,
+  McpGeneric: () => McpGeneric,
+  McpIqWiki: () => McpIqWiki,
+  McpMemory: () => McpMemory,
+  McpNearAgent: () => McpNearAgent,
+  McpNearIntentSwaps: () => McpNearIntentSwaps,
+  McpOdos: () => McpOdos,
   McpSamplingHandler: () => McpSamplingHandler,
+  McpTelegram: () => McpTelegram,
   McpToolset: () => McpToolset,
   ToolContext: () => ToolContext,
   TransferToAgentTool: () => TransferToAgentTool,
@@ -4421,9 +4433,9 @@ var McpSamplingHandler = (_class16 = class {
         mcpParams.messages,
         mcpParams.systemPrompt
       );
+      const requestModel = mcpParams.model || "gemini-2.0-flash";
       const adkRequest = new LlmRequest({
-        model: "",
-        // TODO: Implement model passing from context
+        model: requestModel,
         contents: adkContents,
         config: {
           temperature: mcpParams.temperature,
@@ -4433,7 +4445,10 @@ var McpSamplingHandler = (_class16 = class {
       this.logger.debug("Calling ADK sampling handler");
       const adkResponse = await this.samplingHandler(adkRequest);
       this.logger.debug("Converting ADK response to MCP format");
-      const mcpResponse = this.convertADKResponseToMcp(adkResponse);
+      const mcpResponse = this.convertADKResponseToMcp(
+        adkResponse,
+        requestModel
+      );
       const responseValidation = _typesjs.CreateMessageResultSchema.safeParse(mcpResponse);
       if (!responseValidation.success) {
         this.logger.error(
@@ -4522,7 +4537,7 @@ var McpSamplingHandler = (_class16 = class {
   /**
    * Convert ADK response to MCP response format
    */
-  convertADKResponseToMcp(adkResponse) {
+  convertADKResponseToMcp(adkResponse, model) {
     let responseText = "";
     if (adkResponse.content) {
       if (typeof adkResponse.content === "string") {
@@ -4534,6 +4549,8 @@ var McpSamplingHandler = (_class16 = class {
       }
     }
     const mcpResponse = {
+      model,
+      // Use the model from the request
       role: "assistant",
       // ADK responses are always from assistant
       content: {
@@ -4808,28 +4825,40 @@ var McpClientService = (_class17 = class {
       }
       return;
     }
-    client.setRequestHandler(_typesjs.CreateMessageRequestSchema, async (request) => {
-      try {
-        this.logger.debug("Received sampling request:", request);
-        const response = await this.mcpSamplingHandler.handleSamplingRequest(request);
-        if (this.config.debug) {
-          console.log("\u2705 Sampling request completed successfully");
-        }
-        return response;
-      } catch (error) {
-        console.error("\u274C Error handling sampling request:", error);
-        if (error instanceof McpError) {
-          throw error;
+    try {
+      client.setRequestHandler(
+        _typesjs.CreateMessageRequestSchema,
+        async (request) => {
+          try {
+            this.logger.debug("Received sampling request:", request);
+            const response = await this.mcpSamplingHandler.handleSamplingRequest(request);
+            if (this.config.debug) {
+              console.log("\u2705 Sampling request completed successfully");
+            }
+            return response;
+          } catch (error) {
+            console.error("\u274C Error handling sampling request:", error);
+            if (error instanceof McpError) {
+              throw error;
+            }
+            throw new McpError(
+              `Sampling request failed: ${error instanceof Error ? error.message : String(error)}`,
+              "SAMPLING_ERROR" /* SAMPLING_ERROR */,
+              error instanceof Error ? error : void 0
+            );
+          }
         }
-        throw new McpError(
-          `Sampling request failed: ${error instanceof Error ? error.message : String(error)}`,
-          "SAMPLING_ERROR" /* SAMPLING_ERROR */,
-          error instanceof Error ? error : void 0
+      );
+      if (this.config.debug) {
+        console.log("\u{1F3AF} Sampling handler registered successfully");
+      }
+    } catch (error) {
+      console.error("Failed to setup sampling handler:", error);
+      if (this.config.debug) {
+        console.log(
+          "\u26A0\uFE0F Sampling handler registration failed, continuing without sampling support"
         );
       }
-    });
-    if (this.config.debug) {
-      console.log("\u{1F3AF} Sampling handler registered successfully");
     }
   }
   /**
@@ -5146,6 +5175,117 @@ var McpToolAdapter = (_class18 = class extends BaseTool {
   }
 }, _class18);
 
+// src/tools/mcp/servers.ts
+function createMcpConfig(name, packageName, config) {
+  const { debug, description, retryOptions, env: envVars = {} } = config;
+  const env = {};
+  for (const [key, value] of Object.entries(envVars)) {
+    if (value !== void 0) {
+      env[key] = String(value);
+    }
+  }
+  if (!env.PATH) {
+    env.PATH = process.env.PATH || "";
+  }
+  return {
+    name,
+    description: description || `Client for ${name}`,
+    debug: debug || false,
+    retryOptions: retryOptions || { maxRetries: 2, initialDelay: 200 },
+    transport: {
+      mode: "stdio",
+      command: "npx",
+      args: ["-y", packageName],
+      env
+    }
+  };
+}
+function McpAbi(config) {
+  const mcpConfig = createMcpConfig("ABI MCP Client", "@iqai/mcp-abi", config);
+  return new McpToolset(mcpConfig);
+}
+function McpAtp(config) {
+  const mcpConfig = createMcpConfig("ATP MCP Client", "@iqai/mcp-atp", config);
+  return new McpToolset(mcpConfig);
+}
+function McpBamm(config) {
+  const mcpConfig = createMcpConfig(
+    "BAMM MCP Client",
+    "@iqai/mcp-bamm",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpFraxlend(config) {
+  const mcpConfig = createMcpConfig(
+    "Fraxlend MCP Client",
+    "@iqai/mcp-fraxlend",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpIqWiki(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "IQWiki MCP Client",
+    "@iqai/mcp-iqwiki",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpNearAgent(config) {
+  const mcpConfig = createMcpConfig(
+    "NEAR Agent MCP Client",
+    "@iqai/mcp-near-agent",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpNearIntentSwaps(config) {
+  const mcpConfig = createMcpConfig(
+    "NEAR Intent Swaps MCP Client",
+    "@iqai/mcp-near-intent-swaps",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpOdos(config) {
+  const mcpConfig = createMcpConfig(
+    "ODOS MCP Client",
+    "@iqai/mcp-odos",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpTelegram(config) {
+  const mcpConfig = createMcpConfig(
+    "Telegram MCP Client",
+    "@iqai/mcp-telegram",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpFilesystem(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "Filesystem MCP Client",
+    "@modelcontextprotocol/server-filesystem",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpMemory(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "Memory MCP Client",
+    "@modelcontextprotocol/server-memory",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpGeneric(packageName, config = {}, name) {
+  const clientName = name || `${packageName} Client`;
+  const mcpConfig = createMcpConfig(clientName, packageName, config);
+  return new McpToolset(mcpConfig);
+}
+
 // src/tools/mcp/index.ts
 var McpToolset = (_class19 = class {
   
@@ -10297,4 +10437,16 @@ var VERSION = "0.1.0";
 
 
 
-exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.Agents = agents_exports; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LoopAgent = LoopAgent; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpSamplingHandler = McpSamplingHandler; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor7; exports.codeExecutionResponseProcessor = responseProcessor2; exports.contentRequestProcessor = requestProcessor5; exports.createAuthToolArguments = createAuthToolArguments; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor3; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor4; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor6; exports.nlPlanningResponseProcessor = responseProcessor; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor2; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;
+
+
+
+
+
+
+
+
+
+
+
+
+exports.AF_FUNCTION_CALL_ID_PREFIX = AF_FUNCTION_CALL_ID_PREFIX; exports.Agent = LlmAgent; exports.AgentBuilder = AgentBuilder; exports.Agents = agents_exports; exports.AnthropicLlm = AnthropicLlm; exports.ApiKeyCredential = ApiKeyCredential; exports.ApiKeyScheme = ApiKeyScheme; exports.AuthConfig = AuthConfig; exports.AuthCredential = AuthCredential; exports.AuthCredentialType = AuthCredentialType; exports.AuthHandler = AuthHandler; exports.AuthScheme = AuthScheme; exports.AuthSchemeType = AuthSchemeType; exports.AuthTool = AuthTool; exports.AutoFlow = AutoFlow; exports.BaseAgent = BaseAgent; exports.BaseLLMConnection = BaseLLMConnection; exports.BaseLlm = BaseLlm; exports.BaseLlmFlow = BaseLlmFlow; exports.BaseLlmRequestProcessor = BaseLlmRequestProcessor; exports.BaseLlmResponseProcessor = BaseLlmResponseProcessor; exports.BasePlanner = BasePlanner; exports.BaseSessionService = BaseSessionService; exports.BaseTool = BaseTool; exports.BasicAuthCredential = BasicAuthCredential; exports.BearerTokenCredential = BearerTokenCredential; exports.BuiltInPlanner = BuiltInPlanner; exports.CallbackContext = CallbackContext; exports.DatabaseSessionService = DatabaseSessionService; exports.EnhancedAuthConfig = EnhancedAuthConfig; exports.Event = Event; exports.EventActions = EventActions; exports.Events = events_exports; exports.ExitLoopTool = ExitLoopTool; exports.FileOperationsTool = FileOperationsTool; exports.Flows = flows_exports; exports.FunctionTool = FunctionTool; exports.GcsArtifactService = GcsArtifactService; exports.GetUserChoiceTool = GetUserChoiceTool; exports.GoogleLlm = GoogleLlm; exports.GoogleSearch = GoogleSearch; exports.HttpRequestTool = HttpRequestTool; exports.HttpScheme = HttpScheme; exports.InMemoryArtifactService = InMemoryArtifactService; exports.InMemoryMemoryService = InMemoryMemoryService; exports.InMemoryRunner = InMemoryRunner; exports.InMemorySessionService = InMemorySessionService; exports.InvocationContext = InvocationContext; exports.LLMRegistry = LLMRegistry; exports.LangGraphAgent = LangGraphAgent; exports.LlmAgent = LlmAgent; exports.LlmCallsLimitExceededError = LlmCallsLimitExceededError; exports.LlmRequest = LlmRequest; exports.LlmResponse = LlmResponse; exports.LoadArtifactsTool = LoadArtifactsTool; exports.LoadMemoryTool = LoadMemoryTool; exports.LoopAgent = LoopAgent; exports.McpAbi = McpAbi; exports.McpAtp = McpAtp; exports.McpBamm = McpBamm; exports.McpError = McpError; exports.McpErrorType = McpErrorType; exports.McpFilesystem = McpFilesystem; exports.McpFraxlend = McpFraxlend; exports.McpGeneric = McpGeneric; exports.McpIqWiki = McpIqWiki; exports.McpMemory = McpMemory; exports.McpNearAgent = McpNearAgent; exports.McpNearIntentSwaps = McpNearIntentSwaps; exports.McpOdos = McpOdos; exports.McpSamplingHandler = McpSamplingHandler; exports.McpTelegram = McpTelegram; exports.McpToolset = McpToolset; exports.Memory = memory_exports; exports.Models = models_exports; exports.OAuth2Credential = OAuth2Credential; exports.OAuth2Scheme = OAuth2Scheme; exports.OpenAiLlm = OpenAiLlm; exports.OpenIdConnectScheme = OpenIdConnectScheme; exports.ParallelAgent = ParallelAgent; exports.PlanReActPlanner = PlanReActPlanner; exports.REQUEST_EUC_FUNCTION_CALL_NAME = REQUEST_EUC_FUNCTION_CALL_NAME; exports.ReadonlyContext = ReadonlyContext; exports.RunConfig = RunConfig; exports.Runner = Runner; exports.SequentialAgent = SequentialAgent; exports.Sessions = sessions_exports; exports.SingleFlow = SingleFlow; exports.State = State; exports.StreamingMode = StreamingMode; exports.TelemetryService = TelemetryService; exports.ToolContext = ToolContext; exports.Tools = tools_exports; exports.TransferToAgentTool = TransferToAgentTool; exports.UserInteractionTool = UserInteractionTool; exports.VERSION = VERSION; exports.VertexAiSessionService = VertexAiSessionService; exports.adkToMcpToolType = adkToMcpToolType; exports.agentTransferRequestProcessor = requestProcessor8; exports.basicRequestProcessor = requestProcessor; exports.buildFunctionDeclaration = buildFunctionDeclaration; exports.codeExecutionRequestProcessor = requestProcessor7; exports.codeExecutionResponseProcessor = responseProcessor2; exports.contentRequestProcessor = requestProcessor5; exports.createAuthToolArguments = createAuthToolArguments; exports.createDatabaseSessionService = createDatabaseSessionService; exports.createFunctionTool = createFunctionTool; exports.createMysqlSessionService = createMysqlSessionService; exports.createPostgresSessionService = createPostgresSessionService; exports.createSamplingHandler = createSamplingHandler; exports.createSqliteSessionService = createSqliteSessionService; exports.generateAuthEvent = generateAuthEvent; exports.generateClientFunctionCallId = generateClientFunctionCallId; exports.getLongRunningFunctionCalls = getLongRunningFunctionCalls; exports.getMcpTools = getMcpTools; exports.handleFunctionCallsAsync = handleFunctionCallsAsync; exports.handleFunctionCallsLive = handleFunctionCallsLive; exports.identityRequestProcessor = requestProcessor3; exports.initializeTelemetry = initializeTelemetry; exports.injectSessionState = injectSessionState; exports.instructionsRequestProcessor = requestProcessor4; exports.isEnhancedAuthConfig = isEnhancedAuthConfig; exports.jsonSchemaToDeclaration = jsonSchemaToDeclaration; exports.mcpSchemaToParameters = mcpSchemaToParameters; exports.mergeParallelFunctionResponseEvents = mergeParallelFunctionResponseEvents; exports.newInvocationContextId = newInvocationContextId; exports.nlPlanningRequestProcessor = requestProcessor6; exports.nlPlanningResponseProcessor = responseProcessor; exports.normalizeJsonSchema = normalizeJsonSchema; exports.populateClientFunctionCallId = populateClientFunctionCallId; exports.registerProviders = registerProviders; exports.removeClientFunctionCallId = removeClientFunctionCallId; exports.requestProcessor = requestProcessor2; exports.shutdownTelemetry = shutdownTelemetry; exports.telemetryService = telemetryService; exports.traceLlmCall = traceLlmCall; exports.traceToolCall = traceToolCall; exports.tracer = tracer;

package/dist/index.mjs

@@ -3476,9 +3476,21 @@ __export(tools_exports, {
   HttpRequestTool: () => HttpRequestTool,
   LoadArtifactsTool: () => LoadArtifactsTool,
   LoadMemoryTool: () => LoadMemoryTool,
+  McpAbi: () => McpAbi,
+  McpAtp: () => McpAtp,
+  McpBamm: () => McpBamm,
   McpError: () => McpError,
   McpErrorType: () => McpErrorType,
+  McpFilesystem: () => McpFilesystem,
+  McpFraxlend: () => McpFraxlend,
+  McpGeneric: () => McpGeneric,
+  McpIqWiki: () => McpIqWiki,
+  McpMemory: () => McpMemory,
+  McpNearAgent: () => McpNearAgent,
+  McpNearIntentSwaps: () => McpNearIntentSwaps,
+  McpOdos: () => McpOdos,
   McpSamplingHandler: () => McpSamplingHandler,
+  McpTelegram: () => McpTelegram,
   McpToolset: () => McpToolset,
   ToolContext: () => ToolContext,
   TransferToAgentTool: () => TransferToAgentTool,
@@ -4421,9 +4433,9 @@ var McpSamplingHandler = class {
         mcpParams.messages,
         mcpParams.systemPrompt
       );
+      const requestModel = mcpParams.model || "gemini-2.0-flash";
       const adkRequest = new LlmRequest({
-        model: "",
-        // TODO: Implement model passing from context
+        model: requestModel,
         contents: adkContents,
         config: {
           temperature: mcpParams.temperature,
@@ -4433,7 +4445,10 @@ var McpSamplingHandler = class {
       this.logger.debug("Calling ADK sampling handler");
       const adkResponse = await this.samplingHandler(adkRequest);
       this.logger.debug("Converting ADK response to MCP format");
-      const mcpResponse = this.convertADKResponseToMcp(adkResponse);
+      const mcpResponse = this.convertADKResponseToMcp(
+        adkResponse,
+        requestModel
+      );
       const responseValidation = CreateMessageResultSchema.safeParse(mcpResponse);
       if (!responseValidation.success) {
         this.logger.error(
@@ -4522,7 +4537,7 @@ var McpSamplingHandler = class {
   /**
    * Convert ADK response to MCP response format
    */
-  convertADKResponseToMcp(adkResponse) {
+  convertADKResponseToMcp(adkResponse, model) {
     let responseText = "";
     if (adkResponse.content) {
       if (typeof adkResponse.content === "string") {
@@ -4534,6 +4549,8 @@ var McpSamplingHandler = class {
       }
     }
     const mcpResponse = {
+      model,
+      // Use the model from the request
       role: "assistant",
       // ADK responses are always from assistant
       content: {
@@ -4808,28 +4825,40 @@ var McpClientService = class {
       }
       return;
     }
-    client.setRequestHandler(CreateMessageRequestSchema2, async (request) => {
-      try {
-        this.logger.debug("Received sampling request:", request);
-        const response = await this.mcpSamplingHandler.handleSamplingRequest(request);
-        if (this.config.debug) {
-          console.log("\u2705 Sampling request completed successfully");
-        }
-        return response;
-      } catch (error) {
-        console.error("\u274C Error handling sampling request:", error);
-        if (error instanceof McpError) {
-          throw error;
+    try {
+      client.setRequestHandler(
+        CreateMessageRequestSchema2,
+        async (request) => {
+          try {
+            this.logger.debug("Received sampling request:", request);
+            const response = await this.mcpSamplingHandler.handleSamplingRequest(request);
+            if (this.config.debug) {
+              console.log("\u2705 Sampling request completed successfully");
+            }
+            return response;
+          } catch (error) {
+            console.error("\u274C Error handling sampling request:", error);
+            if (error instanceof McpError) {
+              throw error;
+            }
+            throw new McpError(
+              `Sampling request failed: ${error instanceof Error ? error.message : String(error)}`,
+              "SAMPLING_ERROR" /* SAMPLING_ERROR */,
+              error instanceof Error ? error : void 0
+            );
+          }
         }
-        throw new McpError(
-          `Sampling request failed: ${error instanceof Error ? error.message : String(error)}`,
-          "SAMPLING_ERROR" /* SAMPLING_ERROR */,
-          error instanceof Error ? error : void 0
+      );
+      if (this.config.debug) {
+        console.log("\u{1F3AF} Sampling handler registered successfully");
+      }
+    } catch (error) {
+      console.error("Failed to setup sampling handler:", error);
+      if (this.config.debug) {
+        console.log(
+          "\u26A0\uFE0F Sampling handler registration failed, continuing without sampling support"
         );
       }
-    });
-    if (this.config.debug) {
-      console.log("\u{1F3AF} Sampling handler registered successfully");
     }
   }
   /**
@@ -5146,6 +5175,117 @@ var McpToolAdapter = class extends BaseTool {
   }
 };
 
+// src/tools/mcp/servers.ts
+function createMcpConfig(name, packageName, config) {
+  const { debug, description, retryOptions, env: envVars = {} } = config;
+  const env = {};
+  for (const [key, value] of Object.entries(envVars)) {
+    if (value !== void 0) {
+      env[key] = String(value);
+    }
+  }
+  if (!env.PATH) {
+    env.PATH = process.env.PATH || "";
+  }
+  return {
+    name,
+    description: description || `Client for ${name}`,
+    debug: debug || false,
+    retryOptions: retryOptions || { maxRetries: 2, initialDelay: 200 },
+    transport: {
+      mode: "stdio",
+      command: "npx",
+      args: ["-y", packageName],
+      env
+    }
+  };
+}
+function McpAbi(config) {
+  const mcpConfig = createMcpConfig("ABI MCP Client", "@iqai/mcp-abi", config);
+  return new McpToolset(mcpConfig);
+}
+function McpAtp(config) {
+  const mcpConfig = createMcpConfig("ATP MCP Client", "@iqai/mcp-atp", config);
+  return new McpToolset(mcpConfig);
+}
+function McpBamm(config) {
+  const mcpConfig = createMcpConfig(
+    "BAMM MCP Client",
+    "@iqai/mcp-bamm",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpFraxlend(config) {
+  const mcpConfig = createMcpConfig(
+    "Fraxlend MCP Client",
+    "@iqai/mcp-fraxlend",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpIqWiki(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "IQWiki MCP Client",
+    "@iqai/mcp-iqwiki",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpNearAgent(config) {
+  const mcpConfig = createMcpConfig(
+    "NEAR Agent MCP Client",
+    "@iqai/mcp-near-agent",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpNearIntentSwaps(config) {
+  const mcpConfig = createMcpConfig(
+    "NEAR Intent Swaps MCP Client",
+    "@iqai/mcp-near-intent-swaps",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpOdos(config) {
+  const mcpConfig = createMcpConfig(
+    "ODOS MCP Client",
+    "@iqai/mcp-odos",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpTelegram(config) {
+  const mcpConfig = createMcpConfig(
+    "Telegram MCP Client",
+    "@iqai/mcp-telegram",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpFilesystem(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "Filesystem MCP Client",
+    "@modelcontextprotocol/server-filesystem",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpMemory(config = {}) {
+  const mcpConfig = createMcpConfig(
+    "Memory MCP Client",
+    "@modelcontextprotocol/server-memory",
+    config
+  );
+  return new McpToolset(mcpConfig);
+}
+function McpGeneric(packageName, config = {}, name) {
+  const clientName = name || `${packageName} Client`;
+  const mcpConfig = createMcpConfig(clientName, packageName, config);
+  return new McpToolset(mcpConfig);
+}
+
 // src/tools/mcp/index.ts
 var McpToolset = class {
   config;
@@ -10228,9 +10368,21 @@ export {
   LoadArtifactsTool,
   LoadMemoryTool,
   LoopAgent,
+  McpAbi,
+  McpAtp,
+  McpBamm,
   McpError,
   McpErrorType,
+  McpFilesystem,
+  McpFraxlend,
+  McpGeneric,
+  McpIqWiki,
+  McpMemory,
+  McpNearAgent,
+  McpNearIntentSwaps,
+  McpOdos,
   McpSamplingHandler,
+  McpTelegram,
   McpToolset,
   memory_exports as Memory,
   models_exports as Models,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iqai/adk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Agent Development Kit for TypeScript with multi-provider LLM support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,7 +41,7 @@
     "kysely": "^0.28.2",
     "openai": "^4.93.0",
     "uuid": "^11.1.0",
-    "zod": "^3.24.4"
+    "zod": "^3.25.67"
   },
   "peerDependencies": {
     "better-sqlite3": "^11.10.0",