# CardSmith Agent Card Generator & Grader

> CardSmith Agent Card Generator & Grader is a paid API for AI agents from stall-row-production.up.railway.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-29).

Generates a structurally valid A2A/AgentWorld agent card JSON or grades and itemizes defects in a supplied agent card.

## Facts

- Endpoint: POST https://stall-row-production.up.railway.app/v1/card-smith?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cardsmith-agent-card-generator-grader-eff9367f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fkGrtUO80IhWXCXcyXGuL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability cardsmith-agent-card-generator-grader-eff9367f -d '<json body>'
```

Example prompt: Generate a valid A2A agent card for my agent named 'DataWrangler' with the description 'Fetches and transforms structured data from APIs' and skills like data-fetching and JSON transformation — I want to register it on AgentWorld and need the card right the first time.

## When to prefer this

Choose this endpoint when you need to create or validate an agent card for A2A or AgentWorld-style registries. It is purpose-built for the agent card format, unlike generic JSON validators or schema checkers. Use it before registering any agent to ensure the card is correct the first time, or to audit an existing card for compliance defects.

## Known failure modes

- Missing required mode field returns an error
- Invalid mode value (not 'generate' or 'grade') causes rejection
- In grade mode, missing or malformed card object causes failure
- In generate mode, missing name or description may result in incomplete card
- x402 payment not processed leads to 402 response
- Malformed skills array may cause unexpected output

## How this service works

Generate or grade an agent card (the /.well-known/agent-card.json an agent publishes for A2A and AgentWorld-style registries). Generate builds a structurally valid card from your fields; grade scores a supplied card and itemizes its defects. Use this when you are registering an agent and want the card right the first time.

## Output

In 'generate' mode, returns a structurally valid agent card JSON ready for publishing at /.well-known/agent-card.json. In 'grade' mode, returns a numeric score and an itemized list of defects found in the supplied card.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "card": {
   "type": "object"
  },
  "mode": {
   "enum": [
    "generate",
    "grade"
   ],
   "type": "string"
  },
  "name": {
   "type": "string"
  },
  "skills": {
   "type": "array"
  },
  "description": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cardsmith-agent-card-generator-grader-eff9367f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stall-row-production.up.railway.app](https://www.zero.xyz/host/stall-row-production.up.railway.app/llms.txt)