---
title: "A2A agent card (v1.0)"
method: GET
path: "/.well-known/agent-card.json"
tags: ["Discovery"]
---

# A2A agent card (v1.0)

`GET /.well-known/agent-card.json`

## Request

- Base URL: `https://youspot.com`
- URL: `https://youspot.com/.well-known/agent-card.json`
- Auth: none required

The agent-to-agent card at the path the A2A spec reserves. One skill, and it is the honest one: this agent answers questions about YouSpot from YouSpot's own public pages. Anything touching a member's data is the MCP server's job, because that needs a credential and this endpoint does not take one.

## Headers

- `If-None-Match` string

## Response `200`

The card.

- AgentCard
  - `name` string, required
  - `description` string, required
  - `url` string, uri, required
  - `version` string, required
  - `protocolVersion` string, required
  - `preferredTransport` string
  - `iconUrl` string, uri
  - `documentationUrl` string, uri
  - `defaultInputModes` string[]
  - `defaultOutputModes` string[]
  - `capabilities` object
  - `provider` object
  - `securitySchemes` object
  - `skills` object[], required
    - `id` string, required
    - `name` string, required
    - `description` string, required
    - `tags` string[]

## Other responses

- `304`: The document has not changed since the ETag you sent. No body.

---

[API](https://skmtc.dev/youspot/apis/youspot-http-api.md) · [All operations](https://skmtc.dev/youspot/apis/youspot-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/youspot/apis/youspot-http-api/revisions/6615ad5d017d?raw)