> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proofable.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Discover agents

> Public agent pages, JSON profiles, and A2A / EIP-8004 cards. Other marketplaces can list the same agent.

Every registered Proofable agent has a **public card**: owner, identity, capabilities, and current status other apps can check.

That card is the portable record. Other marketplaces can list the same agent. Proofable keeps identity, control, and proof state in one place.

## Discovery paths

| Path                 | URL                                                                      | Returns                         |
| -------------------- | ------------------------------------------------------------------------ | ------------------------------- |
| Agent page           | `https://proofable.me/agent/{agentId}`                                   | Human-readable profile          |
| Universal JSON       | `https://proofable.me/api/agent/{agentId}?format=json`                   | Identity + permissions + proofs |
| A2A (per agent)      | `https://proofable.me/api/agent/{agentId}?format=a2a`                    | Agent-to-Agent card             |
| A2A (platform)       | `https://proofable.me/.well-known/a2a/agent-card.json`                   | Platform-wide A2A card          |
| EIP-8004 (platform)  | `https://proofable.me/.well-known/agent-card.json`                       | Ethereum registry card          |
| EIP-8004 (per agent) | `https://api.proofable.me/.well-known/agent-card.json?agentId={agentId}` | Per-agent ERC-8004 bridge       |

Per-agent EIP-8004 cards resolve to `GET https://api.proofable.me/api/v1/agents/card/{agentId}`. The platform A2A card is also available at `/api/agent/config?format=a2a`.

## Examples

```bash theme={"dark"}
# Human profile
# https://proofable.me/agent/my-support-agent

# Full Proofable JSON
curl https://proofable.me/api/agent/my-support-agent?format=json

# A2A card for this agent
curl https://proofable.me/api/agent/my-support-agent?format=a2a

# Platform A2A card
curl https://proofable.me/.well-known/a2a/agent-card.json
```

## What a card shows

| Field              | Source           | Visible         |
| ------------------ | ---------------- | --------------- |
| `agentId`          | Identity proof   | Public          |
| `agentWallet`      | Identity proof   | Public          |
| `agentLabel`       | Identity proof   | Public          |
| `description`      | Identity proof   | Public          |
| `capabilities`     | Identity proof   | Public          |
| `skills`           | Identity proof   | Public          |
| `controllerWallet` | Permission proof | Public          |
| `scope`            | Permission proof | Public          |
| `allowedActions`   | Permission proof | Owner-view only |
| `deniedActions`    | Permission proof | Owner-view only |

Public cards do not expose full allow/deny lists. External callers see who the agent is and who approved it, not the full permission matrix.

## Platform A2A card

The platform card includes registered skills, MCP / REST / payment interfaces, auth options (OAuth and profile access keys for servers), and networks listed by CAIP-2 id.

## Cross-chain identifiers

| Network        | CAIP-2                                    |
| -------------- | ----------------------------------------- |
| Base Sepolia   | `eip155:84532`                            |
| Base Mainnet   | `eip155:8453`                             |
| Solana Mainnet | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp` |
| Solana Devnet  | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1` |

## CORS and caching

Discovery endpoints return `Access-Control-Allow-Origin: *`. Platform cards cache for about an hour; per-agent cards cache for about five minutes.

## How to use it

1. **Discover**: fetch the card for the agent you need.
2. **Confirm**: check the permission proof before a sensitive action.
3. **Connect**: call the agent through MCP, A2A, or your own runtime.

## Next

<CardGroup cols={2}>
  <Card title="Agent identity" icon="id-card" href="./agent-identity">
    Register an agent so it appears in discovery.
  </Card>

  <Card title="Team agents" icon="user-group" href="./team-agents">
    One approving account, many agents.
  </Card>

  <Card title="Connect agent context" icon="layer-group" href="./runtime-mount">
    Mount a verified agent into a project.
  </Card>

  <Card title="MCP" icon="plug" href="../mcp/overview">
    Check proofs and resolve agents at runtime.
  </Card>
</CardGroup>