Skip to main content
Glama

get_rpc_url

Retrieve the current RPC URL for blockchain interactions within the EDUCHAIN Agent Kit, enabling direct access to decentralized exchange operations and token data queries.

Instructions

Get the current RPC URL used for blockchain interactions

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Implementation Reference

  • src/index.ts:416-712 (registration)
    Tool registration and schema definition for 'get_rpc_url' in the ListToolsRequestSchema handler, specifying no input parameters.
        {
          name: 'get_rpc_url',
          description: 'Get the current RPC URL used for blockchain interactions',
          inputSchema: {
            type: 'object',
            properties: {},
            required: [],
          },
        },
        {
          name: 'send_edu',
          description: 'Send EDU native token to another wallet address',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the sender wallet',
              },
              toAddress: {
                type: 'string',
                description: 'Recipient wallet address',
              },
              amount: {
                type: 'string',
                description: 'Amount of EDU to send',
              },
            },
            required: ['privateKey', 'toAddress', 'amount'],
          },
        },
        {
          name: 'get_wallet_address_from_private_key',
          description: 'Get wallet address from private key with proper checksum formatting',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the wallet',
              },
            },
            required: ['privateKey'],
          },
        },
        {
          name: 'send_erc20_token',
          description: 'Send ERC20 token to another wallet address',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the sender wallet',
              },
              tokenAddress: {
                type: 'string',
                description: 'Token contract address',
              },
              toAddress: {
                type: 'string',
                description: 'Recipient wallet address',
              },
              amount: {
                type: 'string',
                description: 'Amount of tokens to send',
              },
              confirm: {
                type: 'boolean',
                description: 'Confirm the transaction after verifying wallet address (default: true)',
              },
            },
            required: ['privateKey', 'tokenAddress', 'toAddress', 'amount'],
          },
        },
        {
          name: 'get_swap_quote',
          description: 'Get a quote for swapping tokens on SailFish DEX',
          inputSchema: {
            type: 'object',
            properties: {
              tokenIn: {
                type: 'string',
                description: 'Address of the input token',
              },
              tokenOut: {
                type: 'string',
                description: 'Address of the output token',
              },
              amountIn: {
                type: 'string',
                description: 'Amount of input token to swap',
              },
              fee: {
                type: 'number',
                description: 'Fee tier (100=0.01%, 500=0.05%, 3000=0.3%, 10000=1%)',
              },
            },
            required: ['tokenIn', 'tokenOut', 'amountIn'],
          },
        },
        {
          name: 'swap_tokens',
          description: 'Swap tokens on SailFish DEX (token to token)',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the sender wallet',
              },
              tokenIn: {
                type: 'string',
                description: 'Address of the input token',
              },
              tokenOut: {
                type: 'string',
                description: 'Address of the output token',
              },
              amountIn: {
                type: 'string',
                description: 'Amount of input token to swap',
              },
              slippagePercentage: {
                type: 'number',
                description: 'Slippage tolerance percentage (default: 0.5)',
              },
              fee: {
                type: 'number',
                description: 'Fee tier (100=0.01%, 500=0.05%, 3000=0.3%, 10000=1%)',
              },
            },
            required: ['privateKey', 'tokenIn', 'tokenOut', 'amountIn'],
          },
        },
        {
          name: 'swap_edu_for_tokens',
          description: 'Swap EDU for tokens on SailFish DEX',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the sender wallet',
              },
              tokenOut: {
                type: 'string',
                description: 'Address of the output token',
              },
              amountIn: {
                type: 'string',
                description: 'Amount of EDU to swap',
              },
              slippagePercentage: {
                type: 'number',
                description: 'Slippage tolerance percentage (default: 0.5)',
              },
              fee: {
                type: 'number',
                description: 'Fee tier (100=0.01%, 500=0.05%, 3000=0.3%, 10000=1%)',
              },
            },
            required: ['privateKey', 'tokenOut', 'amountIn'],
          },
        },
        {
          name: 'swap_tokens_for_edu',
          description: 'Swap tokens for EDU on SailFish DEX',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the sender wallet',
              },
              tokenIn: {
                type: 'string',
                description: 'Address of the input token',
              },
              amountIn: {
                type: 'string',
                description: 'Amount of tokens to swap',
              },
              slippagePercentage: {
                type: 'number',
                description: 'Slippage tolerance percentage (default: 0.5)',
              },
              fee: {
                type: 'number',
                description: 'Fee tier (100=0.01%, 500=0.05%, 3000=0.3%, 10000=1%)',
              },
            },
            required: ['privateKey', 'tokenIn', 'amountIn'],
          },
        },
        {
          name: 'get_external_market_data',
          description: 'Get external market data for EDU from centralized exchanges',
          inputSchema: {
            type: 'object',
            properties: {},
            required: [],
          },
        },
        {
          name: 'check_arbitrage_opportunities',
          description: 'Check for arbitrage opportunities between centralized exchanges and SailFish DEX',
          inputSchema: {
            type: 'object',
            properties: {
              threshold: {
                type: 'number',
                description: 'Minimum price difference percentage to consider as an arbitrage opportunity (default: 1.0)',
              },
            },
            required: [],
          },
        },
        {
          name: 'update_external_market_config',
          description: 'Update the configuration for external market data API',
          inputSchema: {
            type: 'object',
            properties: {
              apiUrl: {
                type: 'string',
                description: 'API URL for external market data',
              },
              apiKey: {
                type: 'string',
                description: 'API key for external market data (if required)',
              },
              symbols: {
                type: 'object',
                properties: {
                  EDU: {
                    type: 'string',
                    description: 'Symbol for EDU token on the external API',
                  },
                  USD: {
                    type: 'string',
                    description: 'Symbol for USD on the external API',
                  },
                },
                description: 'Symbol mappings for the external API',
              },
            },
            required: [],
          },
        },
        {
          name: 'get_external_market_config',
          description: 'Get the current configuration for external market data API',
          inputSchema: {
            type: 'object',
            properties: {},
            required: [],
          },
        },
        {
          name: 'wrap_edu',
          description: 'Wrap EDU to WEDU (Wrapped EDU)',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the wallet',
              },
              amount: {
                type: 'string',
                description: 'Amount of EDU to wrap',
              },
            },
            required: ['privateKey', 'amount'],
          },
        },
        {
          name: 'unwrap_wedu',
          description: 'Unwrap WEDU (Wrapped EDU) to EDU',
          inputSchema: {
            type: 'object',
            properties: {
              privateKey: {
                type: 'string',
                description: 'Private key of the wallet',
              },
              amount: {
                type: 'string',
                description: 'Amount of WEDU to unwrap',
              },
            },
            required: ['privateKey', 'amount'],
          },
        },
      ],
    }));
  • Handler implementation in CallToolRequestSchema that invokes blockchain.getRpcUrl() and returns the RPC URL as JSON text content.
    case 'get_rpc_url': {
      const rpcUrl = blockchain.getRpcUrl();
      
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({ rpcUrl }, null, 2),
          },
        ],
      };
  • Helper function getRpcUrl() that returns the current RPC URL variable used by the blockchain provider.
    export function getRpcUrl(): string {
      return rpcUrl;
    }
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves the current RPC URL, implying a read-only operation, but doesn't clarify aspects like error handling (e.g., if no URL is set), performance characteristics, or return format. This leaves gaps in understanding how the tool behaves in practice.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, clear sentence: 'Get the current RPC URL used for blockchain interactions.' It is front-loaded with the core purpose, has no redundant information, and efficiently conveys the essential meaning without unnecessary details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (0 parameters, no annotations, no output schema), the description is adequate but minimal. It explains what the tool does but lacks details on output (e.g., what format the URL is returned in) and behavioral context. For a read-only tool with no parameters, it meets basic needs but could be more informative about the result.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, and the schema description coverage is 100%, so there are no parameters to document. The description doesn't need to add parameter semantics, and it appropriately doesn't mention any. A baseline of 4 is applied as it meets expectations for a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Get the current RPC URL used for blockchain interactions.' It specifies the verb ('Get') and resource ('current RPC URL'), and the context ('for blockchain interactions') provides additional clarity. However, it doesn't explicitly differentiate from its sibling tool 'set_rpc_url', which is a related but distinct operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., whether an RPC URL must be set first), exclusions, or comparisons to other tools like 'set_rpc_url' for configuration. Usage is implied by the purpose but lacks explicit context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Related Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SailFish-Finance/educhain-ai-agent-kit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server