Skip to content

CapiscIO Documentation

The Authority Layer for the Agent-to-Agent (A2A) Protocol.
Validate compliance. Verify identity. Secure your agents.

Quickstarts

Get started in minutes. Each quickstart is self-contained and builds on practical examples.

  • Validate Your Agent

    Ensure your agent card is A2A-compliant with the CapiscIO CLI.

    5 minutes · Beginner

    Start Validating

  • Secure Your Agent

    Add cryptographic identity and request verification to your agent.

    15 minutes · Intermediate

    Add Security

  • CI/CD Integration

    Automate validation in GitHub Actions with PR comments and quality gates.

    10 minutes · Intermediate

    Setup CI/CD

Try It Now

Install the CLI and validate a sample agent card in under 60 seconds:

npm install -g capiscio   # or: pip install capiscio

curl -O https://docs.capisc.io/assets/samples/agent-card.json

capiscio validate agent-card.json

[32m✅ A2A AGENT VALIDATION PASSED[0m

Score: [1m85/100[0m

[32m✓[0m Schema validation passed
[32m✓[0m Required fields present  
[32m✓[0m Skills properly defined
[33m○[0m Endpoint not tested (use --test-live)

Download Sample Files Full Quickstart

Learn the Concepts

  • How Validation Works

    Understand the three-dimensional scoring system: Compliance, Trust, and Availability.

    Validation Process

  • Understanding Scores

    What the numbers mean and how to improve them.

    Scoring System

  • Enforcement First

    How Guard verifies requests.

    Enforcement Guide

  • Trust Model

    How keys and trust stores work.

    Trust Model

Reference Documentation

Complete API documentation for every package in the ecosystem.

  • CLI Reference

    All commands, flags, and examples.

    CLI Docs

  • Python SDK

    SimpleGuard, Executor, and all classes.

    SDK Docs

  • Agent Card Schema

    Complete JSON Schema reference.

    Schema Docs

  • Configuration

    All config options and environment variables.

    Config Docs

RFCs

Formal proposals for significant changes to CapiscIO protocols and standards.

  • RFC-001: AGCP v5.0

    Agent-to-Guard Communication Protocol — the foundation for secure agent communication.

    Read RFC

  • Propose an RFC

    Have an idea for improving CapiscIO? Learn how to submit a proposal.

    Contributing Guide

Common Questions

What's the difference between the CLI and SDK?

CLI tools (capiscio on npm/pip) are for validation - checking that agent cards are A2A-compliant.

The SDK (capiscio-sdk on pip) is for security - adding cryptographic identity and request verification to your running agent.

Do I need to run the Go binary directly?

No! The Node.js and Python CLIs automatically download and run the correct binary for your platform. Use the wrapper that matches your development environment.

What's a compliance score of 85 mean?

Your agent card passes all required A2A fields and 85% of recommended best practices. See Understanding Scores for the full breakdown.

Resources