Skip to content

Know Your Agent (KYA) - The missing identity layer for AI agents. Get verifiable identity, ownership tracking, and compliance-ready agent cards in one API call.

License

Notifications You must be signed in to change notification settings

AstraSyncAI/astrasync-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

41 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

AstraSync API

AstraSync Logo

Know Your Agent (KYA) Registry

API Status Version Discord License

The missing identity layer for AI agents. Get verifiable identity, ownership tracking, and compliance-ready agent cards in one API call.

πŸš€ Quick Start

Register your AI agent in 30 seconds:

curl -X POST https://astrasync.ai/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "developer@example.com",
    "agent": {
      "name": "My AI Assistant",
      "description": "A helpful AI agent for customer support",
      "owner": "ACME Corp",
      "capabilities": ["chat", "analysis", "automation"]
    }
  }'

You'll receive:

{
  "agentId": "TEMP-1706439245-X7K9M2",
  "status": "registered",
  "blockchain": {
    "status": "pending",
    "message": "Blockchain registration queued. You will be notified upon completion."
  },
  "trustScore": "TEMP-95%",
  "message": "Agent registered successfully with temporary credentials. Create an account at https://www.astrasync.ai/alphaSignup to convert to permanent credentials.",
  "verifyUrl": "https://astrasync.ai/api/v1/verify/TEMP-1706439245-X7K9M2"
}

🌟 Why AstraSync?

As AI agents become more autonomous and widespread, organizations face a growing crisis:

  • ❌ No Universal Identity: AI agents lack standardized identification
  • ❌ Ownership Ambiguity: Who's responsible when an agent acts?
  • ❌ Compliance Gaps: No audit trail for agent actions
  • ❌ Trust Deficit: No way to verify agent legitimacy

AstraSync solves these problems with:

  • βœ… Unique Identity: Every agent gets a cryptographically unique identifier
  • βœ… Ownership Tracking: Clear chain of custody for agent ownership
  • βœ… Blockchain Verified: Immutable record of agent registration
  • βœ… Trust Scoring: Dynamic trust scores based on agent behavior
  • βœ… Compliance Ready: Built for regulatory requirements

πŸ“‹ API Endpoints

Base URL

https://astrasync.ai/api

1. Register Agent

POST /v1/register

Register a new AI agent and receive a unique identifier.

Request Body

{
  "email": "your-email@example.com",
  "agent": {
    "name": "Agent Name",
    "description": "What your agent does",
    "owner": "Your Organization",
    "capabilities": ["capability1", "capability2"],
    "version": "1.0.0",
    "metadata": {
      "custom_field": "custom_value"
    }
  }
}

Required Fields

  • email: Valid email for notifications and alpha enrollment
  • agent.name: Your agent's name
  • agent.description: Brief description of functionality
  • agent.owner: Organization or individual owning the agent

Response

{
  "agentId": "TEMP-1706439245-X7K9M2",
  "status": "registered",
  "blockchain": {
    "status": "pending",
    "message": "Blockchain registration queued"
  },
  "trustScore": "TEMP-95%",
  "message": "Registration successful",
  "verifyUrl": "https://astrasync.ai/api/v1/verify/TEMP-..."
}

2. Verify Agent

GET /v1/verify/{agentId}

Verify if an agent is registered and retrieve its status.

Example

curl https://astrasync.ai/api/v1/verify/TEMP-1706439245-X7K9M2

Response

{
  "verified": true,
  "agentId": "TEMP-1706439245-X7K9M2",
  "owner": "ACME Corp",
  "registeredAt": "2025-01-28T12:34:56Z",
  "trustScore": "TEMP-95%",
  "message": "This is a temporary developer preview credential..."
}

3. Get Agent Details

GET /v1/agent/{agentId}?email={email}

Retrieve full agent details (requires matching email).

Example

curl "https://astrasync.ai/api/v1/agent/TEMP-1706439245-X7K9M2?email=developer@example.com"

πŸ“± Platform Support

Platform MCP Support Integration Method Setup Guide
Claude Desktop βœ… Native HTTP MCP Instructions
ChatGPT Desktop βœ… Native HTTP MCP Instructions
Cursor βœ… Native HTTP MCP Instructions
Windsurf βœ… Native HTTP MCP Instructions
Cline βœ… Native HTTP MCP Instructions
Claude Web ❌ Not supported Copy/paste workflow Workaround
ChatGPT Web ❌ Not supported Custom GPT Actions Alternative
Perplexity ❌ Not yet Direct API Use REST endpoint directly

πŸ” Authentication & Security

Production

  • Email verification for agent ownership
  • Rate limiting: 100 requests per hour
  • API key authentication for verified accounts
  • HTTPS encryption for all communications

πŸ“Š Production Features

βœ… Available Now

  • Agent registration with production IDs (ASTRAS-XXXXXX)
  • Email notifications for registration
  • Ownership tracking and verification
  • Dynamic trust scoring (0-100 scale)
  • Customer intelligence logging
  • Blockchain registration queuing

πŸ”„ Coming Soon

  • Live blockchain verification
  • Ownership transfers
  • Webhook notifications
  • Advanced compliance features
  • Multi-signature agent management

🎯 Use Cases

For AI Developers

  • Register agents before deployment
  • Track agent versions and updates
  • Prove ownership for liability protection

For Enterprises

  • Maintain inventory of AI agents
  • Compliance with AI regulations
  • Audit trail for agent actions

For Platforms

  • Verify agent legitimacy
  • Filter trusted vs untrusted agents
  • Enable agent marketplaces

🀝 Becoming an Alpha Partner

We're building the future of AI agent trust infrastructure and looking for early partners to shape the product.

Benefits of Joining

  • Direct input on product features
  • Priority access to new capabilities
  • Lifetime discounted pricing
  • Technical support from founders

To become an alpha partner or contribute to the project, contact us at alphapartners@astrasync.ai.

πŸ“ž Support & Community

πŸ”’ Security

  • All API communications use HTTPS
  • Database encryption at rest
  • Regular security audits
  • Report security issues to: alphapartners@astrasync.ai

πŸ“„ License

Proprietary - All rights reserved. Contact alphapartners@astrasync.ai for licensing inquiries.


Building the trust infrastructure for the AI agent economy.

🌟 Join the Alpha Program: Sign up now
πŸ“§ For partnership opportunities: alphapartners@astrasync.ai

About

Know Your Agent (KYA) - The missing identity layer for AI agents. Get verifiable identity, ownership tracking, and compliance-ready agent cards in one API call.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •