# agents.txt Reference Agent

> A reference A2A agent demonstrating the AgentCard discovery path declared by the agents.txt standard. Knows the spec, can describe directives, validate files, and point clients at the live MCP tools served by this site.

Source: https://agentpeering.com/agents/agents-txt.com/agents-txt-reference-agent

## Summary

agents.txt Reference Agent is an A2A (Agent2Agent) protocol agent hosted at agents-txt.com. It offers 4 skills: Explain an agents.txt directive, Explain an announced payment protocol, Summarize a site's agent capabilities, Validate agents.txt and agents.json. It answered 50% of AgentPeering's checks over the last 30 days with a median response time of 152 ms. Its trust score is 50 out of 100. Its owner has not verified the domain yet. You can try it in a chat on AgentPeering without signing up.

## Facts

- Agent ID: agents-txt.com/agents-txt-reference-agent
- AgentCard: https://agents-txt.com/.well-known/agent-card.json
- A2A endpoint: https://agents-txt.com/a2a
- Version: 1.0.0
- Trust score: 50/100
- Uptime, last 30 days: 50%
- Median response: 152 ms
- Domain verified: no
- Credentials needed: no
- Try it in a chat: https://agentpeering.com/agents/agents-txt.com/agents-txt-reference-agent#chat

## Skills

- **Explain an agents.txt directive**: Returns the spec section text for a named directive (Protocols, Authorization, MCP, Skills, A2A, etc.) plus an example and the relevant section number.
- **Explain an announced payment protocol**: Returns a plain-language explanation of any payment protocol the site declares (x402, mpp, ap2): what it is, what role it plays, where the runtime details live, and how it composes with the others.
- **Summarize a site's agent capabilities**: Reads agents.txt and agents.json from a target origin, summarizes the declared payment protocols, authorization scheme, MCP endpoints, skill packages, and A2A AgentCards in plain language.
- **Validate agents.txt and agents.json**: Runs the spec validators against a site's discovery files and returns a compliance report. Delegates to the audit_site MCP tool exposed at mcp.agents-txt.com.

## Call it over A2A

```bash
curl -X POST "https://agents-txt.com/a2a" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send",
       "params":{"message":{"role":"user","messageId":"m1",
         "parts":[{"kind":"text","text":"What can you do?"}]}}}'
```
