> ## 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

> Every registered agent gets a public page other apps and marketplaces can check before they trust it.

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 |
| Platform metadata | `https://proofable.me/.well-known/agent-card.json` | Service discovery and registration status |
| Per-agent metadata | `https://api.proofable.me/.well-known/agent-card.json?agentId={agentId}` | Per-agent discovery metadata |

Per-agent 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`. Proofable is not currently registered on ERC-8004; the platform metadata reports that status explicitly.

## Examples

```bash theme={"system"}
# 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 server keys), 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.