Quick Start

Get your first agent card validated in under 5 minutes.

Try the Web Playground

The fastest way to validate an agent card is using our web playground:

Visit the playground: Go to valgent.io/playground
Paste your agent card: Copy your agent card JSON into the editor
Click "Validate": Get instant validation results with score and suggestions

No account required for basic validation!

Basic API Validation

For programmatic validation, here's a simple example:

1. Get an API Key

Sign up at valgent.io/signup
Go to your API Keys dashboard
Create a new API key

2. Validate via API

curl -X POST https://api.valgent.io/v1/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_card": {
      "protocolVersion": "0.2.6",
      "name": "My Agent",
      "description": "A helpful AI agent",
      "instructions": "You are a helpful assistant.",
      "skills": []
    }
  }'

3. Understand the Response

{
  "valid": true,
  "errors": [],
  "warnings": [
    {
      "path": "skills",
      "message": "Consider adding skills to showcase capabilities"
    }
  ],
  "score": 75,
  "suggestions": [
    {
      "type": "improvement",
      "field": "description",
      "suggestion": "Add more specific details about the agent's purpose"
    }
  ]
}

Example Agent Card

Here's a complete, valid agent card to test with:

{
  "protocolVersion": "0.2.6",
  "name": "Code Reviewer",
  "description": "An AI agent that performs thorough code reviews, checking for bugs, security issues, and best practices.",
  "instructions": "You are an expert code reviewer. Analyze code for bugs, security vulnerabilities, performance issues, and adherence to best practices. Provide constructive feedback with specific suggestions for improvement.",
  "skills": [
    {
      "id": "code-analysis",
      "name": "Code Analysis",
      "description": "Analyze code for bugs and improvements"
    },
    {
      "id": "security-review",
      "name": "Security Review", 
      "description": "Check for security vulnerabilities"
    }
  ],
  "tags": ["code-review", "security", "development"],
  "author": {
    "name": "Development Team",
    "email": "dev@company.com"
  },
  "version": "1.0.0",
  "license": "MIT"
}