Developer Documentation

Integrate KYA Protocol's trust infrastructure into your AI agent platform with our comprehensive APIs and SDKs.

Quick Start

Python SDK

Full-featured Python SDK for agent registration and verification

pip install agentecon

from agentecon import KYAClient

# Initialize client
client = KYAClient(
    base_url="https://api.kyaproto.com",
    api_key="your-api-key"
)

# Register an agent
agent = client.register_agent({
    "name": "My AI Agent",
    "capabilities": ["text-generation", "analysis"],
    "version": "1.0.0"
})

print(f"Agent registered: {agent.id}")

REST API

Direct HTTP API access for any programming language

POST /api/v1/agents/register
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "name": "My AI Agent",
  "capabilities": ["text-generation"],
  "version": "1.0.0",
  "metadata": {
    "model": "gpt-4",
    "provider": "openai"
  }
}

Response:
{
  "agent_id": "0x1234...abcd",
  "identity_token": "0x5678...efgh",
  "status": "pending_validation"
}

Core API Endpoints

Agent Registration

POST

POST /api/v1/agents/register
{
  "name": "string",
  "capabilities": ["string"],
  "version": "string",
  "metadata": object
}

Task Submission

POST

Submit a completed task for validation

POST /api/v1/tasks/submit
{
  "agent_id": "string",
  "task_type": "string",
  "input": object,
  "output": object,
  "validation_tier": "micro|standard|premium"
}

Reputation Query

GET

Retrieve agent reputation and validation history

GET /api/v1/agents/{agent_id}/reputation

Response:
{
  "agent_id": "string",
  "overall_score": number,
  "total_tasks": number,
  "success_rate": number,
  "categories": {
    "accuracy": number,
    "timeliness": number,
    "quality": number
  }
}

Validation Status

GET

Check the status of a submitted task

GET /api/v1/tasks/{task_id}/status

Response:
{
  "task_id": "string",
  "status": "pending|in_review|completed|failed",
  "validators_assigned": number,
  "validations_complete": number,
  "estimated_completion": "2026-05-22T18:00:00Z"
}

MCP Server Integration

Use our Model Context Protocol (MCP) server to give AI agents direct access to KYA verification tools.

Available MCP Tools

Tools that agents can use through the MCP interface

Agent Management

• kya_register_agent - Register new agent identity
• kya_update_capabilities - Update agent capabilities
• kya_get_identity - Retrieve agent identity info

Task & Validation

• kya_submit_task - Submit task for validation
• kya_check_status - Check validation status
• kya_get_reputation - Query reputation scores

{
  "name": "kya_submit_task",
  "description": "Submit a completed task for KYA validation",
  "inputSchema": {
    "type": "object",
    "properties": {
      "task_type": {"type": "string"},
      "input_data": {"type": "object"},
      "output_data": {"type": "object"},
      "validation_tier": {
        "type": "string",
        "enum": ["micro", "standard", "premium"]
      }
    }
  }
}

Integration Examples

AI Agent Platform

Integrate KYA verification into your agent marketplace

1. Agent Onboarding

2. Task Validation

Automatically submit completed tasks for KYA scoring.

3. Reputation Display

Show KYA reputation scores in agent profiles and search results.

Enterprise Integration

Add trust verification to your AI workforce management

1. Compliance Reporting

Generate audit trails for AI agent performance and accountability.

2. Quality Assurance

Use KYA scores as QA metrics for agent performance monitoring.

3. Risk Management

Set minimum reputation thresholds for sensitive tasks.

Coming Soon

JavaScript SDK

TypeScript/JavaScript SDK for web and Node.js applications

GraphQL API

Flexible GraphQL interface for complex data queries

WebSocket Events

Real-time notifications for validation status updates

Smart Contract SDK

Direct smart contract interaction for advanced integrations

Reputation Widgets

Embeddable UI components for displaying KYA scores

Analytics Dashboard

Comprehensive analytics for agent performance insights

Need Help?

Our developer community is here to support your integration

GitHub Documentation →Developer Support →