Skip to main content
Glama

sign_receive_with_erc3009_authorization

Read-only

Generates EIP-712 typed data for an ERC-3009 ReceiveWithAuthorization (e.g. USDC). Authorizes the spender (default: protocol diamond) to pull value from signerAddress between validAfter and validBefore. Sign locally with your wallet (EIP-712); add the resulting signature to the returned transferAuthorization { strategy: 'ERC3009', data } and pass it in send_meta_transaction.transferAuthorizations. Returns: typedData to sign + transferAuthorization template.

Input Schema

NameRequiredDescriptionDefault
valueYesAmount in wei the spender is authorized to pull from the signer.
spenderNoOptional spender address. Defaults to the Boson Protocol diamond from SDK config.
configIdYesBoson/Fermion Protocol deployment identifier. Format: '<env>-<chainId>-<index>' e.g. 'production-137-0' (Polygon mainnet), 'testing-80002-0' (Amoy testnet). Call get_config_ids to list all valid values for this server.
validAfterYesUnix timestamp in seconds before which the authorization is not valid.
validBeforeYesUnix timestamp in seconds after which the authorization is no longer valid.
signerAddressYesEthereum address that will sign and send this transaction. Must match the wallet that will sign the returned transaction locally.
tokenDomainNameYesEIP-712 domain name of the token contract (e.g. 'USD Coin'). Required for ERC-3009 / EIP-2612 domain separator.
tokenDomainVersionYesEIP-712 domain version of the token contract (e.g. '2'). Required for ERC-3009 / EIP-2612 domain separator.
exchangeTokenAddressYesERC-20 token contract address that supports the permit/authorization standard.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

readOnlyHint=true is consistent with a tool that only produces typed data and never signs or sends, so there is no contradiction. The description adds real behavioral context beyond the annotation: the default spender is the protocol diamond, signing happens locally, and the return is a typedData payload plus a transferAuthorization template (strategy 'ERC3009').

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

Conciseness4/5

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

Three densely-packed sentences that are front-loaded with the operation and end with the write/send instructions. Slight redundancy in the trailing 'Returns: typedData to sign + transferAuthorization template' sentence, which echoes earlier content, keeps it from being maximally tight.

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

Completeness4/5

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

For a 9-parameter crypto tool with no output schema, the description supplies the missing return shape and downstream integration path, which covers the main gaps. It could still say more about how it relates to the sibling permit variants, but nothing essential for correct invocation is absent.

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

Parameters3/5

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

Schema description coverage is 100%, so the baseline is 3. The description restates value, signerAddress, validAfter and validBefore, and notes the spender default, but adds little syntax or format detail beyond what the schema already documents.

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

Purpose5/5

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

States a specific verb ('Generates EIP-712 typed data') and a precise resource (ERC-3009 ReceiveWithAuthorization, e.g. USDC). The named standard implicitly separates it from the sibling sign_receive_with_dai_permit, sign_receive_with_erc2612_permit and sign_receive_with_permit2 tools, so an agent can route without opening the schema.

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

Usage Guidelines4/5

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

Gives a clear workflow: sign locally with EIP-712, attach the signature to the returned transferAuthorization, and pass it through send_meta_transaction.transferAuthorizations, explicitly naming the downstream tool. It lacks an explicit statement of when to choose ERC-3009 over the other permit variants, so it stops short of full exclusion guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources