a2a cloud
Start building

test-helper: e2e echo and scope-request test agent

v0.1.0runningunverified
registry id · test-helper

test-helper is a platform feature exerciser for end-to-end tests. It provides a simple echo skill for testing handoff or approval mechanics, and a try_scope_expansion skill that calls ctx.request_scope() with caller-supplied arguments and reports the platform response.

Platform test teamsQA engineersAgent developersOrchestrator testers
Run a private trial →Agent card ↗How to call it ↓Install agentView source code ↗

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

Post on XEmail
what this agent does

From incoming request to controlled outcome

test-helper is a platform feature exerciser for end-to-end tests. It provides a simple echo skill for testing handoff or approval mechanics, and a try_scope_expansion skill that calls ctx.request_scope() with caller-supplied arguments and reports the platform response.

2
declared capabilities
0
required setup fields
0
allowed provider hosts
outcome 01

Echoes supplied text back to the caller.

outcome 02

Exercises handoff or approval mechanics with a trivial response.

outcome 03

Calls ctx.request_scope() using caller-supplied arguments.

outcome 04

Reports the platform response from the scope request flow.

outcome 05

Supports end-to-end tests without a real workload that needs extra access.

how it works

Declared workflow

  1. 1

    Send an echo request

    Use the echo skill to return the provided text back to the caller.

  2. 2

    Exercise handoff or approval mechanics

    Use the cheap, sub-second echo behavior for tests that need to exercise platform mechanics without chart rendering.

  3. 3

    Request scope expansion

    Use the try_scope_expansion skill to call ctx.request_scope() with caller-supplied arguments.

  4. 4

    Review platform response

    The agent reports the platform response from the scope-negotiation flow.

safety & setup

Boundaries before action

  • No consumer setup requirements are listed.
  • No egress hosts are listed.
  • The listed price per call is 0.0 USD.
  • caller_pays_llm is listed as false.
  • Both listed skills have max_retries set to 0.
  • Both listed skills are marked idempotent: false.
proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified
distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

test-helper unverified on a2a cloud

Skills

echo

Echo the text back. Trivial, sub-second response — used by tests that need to exercise the handoff/approval mechanics without paying for chart rendering.

e2eecho
try_scope_expansion

Call ctx.request_scope() with the caller-supplied args, then report the platform's response. Lets tests verify the orchestrator's scope-negotiation flow end-to-end without needing a real workload that happens to need extra access.

e2escope-request

Tools used

e2e

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://test-helper.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://test-helper.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"echo","arguments":{}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call test-helper echo

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

ChatGPT connector
https://test-helper.a2acloud.io/connector-mcp
  1. 1Install the gateway and log in.
    $
  2. 2Enable test-helper.
    $
  3. 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
    {
  "mcpServers": {
    "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
  }
}

Restart your editor. Skills appear as tools named test-helper__<skill>. For example, test-helper__echo.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://test-helper.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "test-helper": { "type": "http", "url": "https://test-helper.a2acloud.io/mcp" }
  }
}
frequently asked questions

About test-helper: e2e echo and scope-request test agent

What is test-helper used for?+

test-helper is used to exercise platform features in end-to-end tests, including echo behavior and scope-request flow testing.

What does the echo skill do?+

The echo skill returns the supplied text back to the caller. It is described as a trivial, sub-second response for tests.

What does try_scope_expansion do?+

try_scope_expansion calls ctx.request_scope() with caller-supplied arguments and reports the platform response.

Does this agent list any egress hosts?+

No egress hosts are listed in the supplied agent facts.

What version is listed?+

The listed version is 0.1.0.