• SYNC
  • ASYNC
  • STATUS
  • HUMAN

How to relay signed transactions with your AI

Connect Gelato to your agent to offload transaction execution. Your AI handles the handoff to the network so you don't have to manage gas or low-level relay logic.

Ask AI about this page

Short answer

How can my AI relay signed transactions?

Your agent uses Gelato tools to send pre-signed transaction data to the network. You can choose between synchronous execution or asynchronous relaying depending on your needs. This breakdown shows how your agent manages the process.

Transaction outcomes

Where the data goes

What happens after your agent sends the payload.

SYNC

Immediate execution

The agent waits for the transaction to process. You get a direct result from the network immediately.

ASYNC

Background relaying

The agent hands the transaction to the network and moves on. This is best for tasks that don't need an instant response.

STATUS

Tracking progress

Your agent can check on pending transactions. You'll know exactly when a relay succeeds or fails.

HUMAN

Manual intervention

If a transaction fails or requires a signature you haven't provided, the agent will alert you. You decide how to fix it.

The workflow

What your AI does when the transaction arrives.

The agent takes your signed data and interfaces with the Gelato relayers.

  1. Submit the payload

    The agent takes your signed transaction and sends it to the Gelato relayers.

    relayer_send_transactionrelayer_send_transaction_sync

  2. Monitor the relay

    The agent tracks the status of the submission to ensure it hits the chain.

    relayer_get_status

  3. Confirm execution

    The agent verifies that the transaction was included in a block.

    relayer_get_status

  4. Report results

    The agent tells you if the relay was successful or if it hit a snag.

    relayer_get_status

Try it

Copy these to start.

Use these prompts to trigger the Gelato tools.

Starting points

Swap the bracketed info for your actual transaction hex or signed data.

Gelato Network Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_GEOLbnCleYGrUXwyjYCQIsNu6juUEnsytlCxzwcq/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Gelato Network capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gelato-network-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_GEOLbnCleYGrUXwyjYCQIsNu6juUEnsytlCxzwcq/mcp"
    }
  }
}
Copy into chat04

  • Relay this signed transaction asynchronously: [insert hex data]

  • Perform a synchronous relay for this transaction: [insert hex data]

  • Check the status of my last transaction relay.

  • Relay this transaction and let me know once it's confirmed.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Gelato once, then ask.

One connection gives your agent access to the Gelato relay tools. All credentials stay encrypted and secure.

Connect Gelato to your AI

FAQ

How the relaying behaves

  • 01

    Can the AI sign the transaction for me?

    No. The AI can only relay transactions that you have already signed. It does not have access to your private keys.

  • 02

    What is the difference between the two relay methods?

    One method waits for the transaction to finish before responding, while the other sends it and moves on immediately.

  • 03

    Can the AI change the transaction data?

    No. The agent sends the exact signed payload you provide. It cannot modify the destination, amount, or nonce.

  • 04

    How does the agent know if the relay failed?

    The agent uses status tools to check the transaction on the network and will report any errors it finds.

  • 05

    Does the AI pay the gas fees?

    The agent uses the Gelato relay service to handle the execution, but the transaction must be valid and prepared for relaying.

  • More questions about Gelato? See everything the Gelato Connector can do

Connect Gelato Network to Claude, Cursor, ChatGPT & more