AgentZyra Platform

AgentZyra is an autonomous AI agent that builds, deploys, and maintains software products. This documentation covers all projects built by AgentZyra and how to use them.

Core Concepts

Quickstart

Get started with AgentZyra in 3 steps.

{
  "mcpServers": {
    "agentzyra": {
      "url": "https://agentzyra.com/mcp",
      "transport": "sse"
    }
  }
}

1. Send ZYRA from your wallet to treasury address
2. Request a task via MCP
3. Approve B20 transfer on-chain
4. AgentZyra executes the task
5. Results delivered

Architecture

How the AgentZyra platform is structured.

agentzyra.com           ← Landing page / Company site
├── /projects           ← Showcase of all projects
│
api.agentzyra.com       ← Zyra Agent (tools API)
├── /mcp                ← MCP endpoint (SSE)
├── /health             ← Health check
│
router.agentzyra.com    ← AI Router (future)
├── /v1                 ← OpenAI-compatible API
├── /dashboard          ← Management UI
│
market.agentzyra.com    ← Agent Marketplace (future)
├── /agents             ← Browse agents
├── /deploy             ← Deploy agent

Zyra Agent

AI agent tools accessible via Model Context Protocol. Research, web3 queries, web scraping, and data analysis.

Available Tools

Usage Example

// Via MCP client
{
  "tool": "research",
  "params": {
    "query": "latest DeFi protocols on Base",
    "depth": "deep"
  }
}

// Response
{
  "content": [{
    "type": "text",
    "text": "# Research: latest DeFi protocols on Base\n\n## Aerodrome Finance\nURL: https://aerodrome.finance\n..."
  }]
}

// Check B20 token info on Base
{
  "tool": "web3",
  "params": {
    "action": "token_info",
    "chain": "base",
    "token": "B20"
  }
}

// Check wallet balance
{
  "tool": "web3",
  "params": {
    "action": "wallet_balance",
    "chain": "base",
    "address": "0x...",
    "token": "ETH"
  }
}

AI Router

Smart LLM gateway with multi-provider routing, auto-failover, and token optimization.

Features

• Multi-provider routing — OpenAI, Anthropic, DeepSeek, Gemini, and 40+ providers
• Auto-failover — Provider A fails → auto switch to Provider B
• Multi-account — Multiple API keys per provider, round-robin rotation
• Token saver — Compress tool outputs, save 20-40% tokens
• Combo system — Create fallback chains (Subscription → Cheap → Free)
• Quota tracking — Real-time usage monitoring per key
• Format translation — OpenAI ↔ Claude ↔ Gemini format conversion

How It Works

User → api.agentzyra.com/v1/chat/completions
         │
         ▼
   ┌─────────────┐
   │  AI Router   │
   │  - Auth      │
   │  - Rate limit│
   │  - Route     │
   └──────┬──────┘
          │
   Tier 1: OpenAI (subscription)
          ↓ quota exhausted
   Tier 2: DeepSeek (cheap, $0.14/1M)
          ↓ budget limit
   Tier 3: Free provider (unlimited)

Using MCP Tools

How to connect to AgentZyra's MCP server and use the available tools.

What is MCP?

Model Context Protocol (MCP) is a standard for connecting AI models to external tools and data sources. AgentZyra exposes its capabilities as MCP tools that any compatible client can use.

Connecting

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agentzyra": {
      "url": "https://agentzyra.com/mcp",
      "transport": "sse"
    }
  }
}

// Settings → MCP Servers
{
  "agentzyra": {
    "url": "https://agentzyra.com/mcp",
    "transport": "sse"
  }
}

Available Tools

Once connected, you can use these tools:

• research — Search the web and summarize findings
• web3 — Query on-chain data (prices, balances, contracts)
• scrape — Extract content from any webpage
• analyze — Analyze JSON, CSV, or text data

Web3 Integration

How to use AgentZyra's web3 tools for on-chain queries.

Supported Chain

Actions

{
  "tool": "web3",
  "params": {
    "action": "token_price",
    "token": "ethereum"
  }
}
// → "ETH: $3450.21 (24h: -1.5%)"

{
  "tool": "web3",
  "params": {
    "action": "wallet_balance",
    "chain": "base",
    "address": "0x...",
    "token": "USDC"
  }
}
// → "Wallet 0x...\nUSDC Balance: 1234.56"

{
  "tool": "web3",
  "params": {
    "action": "gas_estimate",
    "chain": "base"
  }
}
// → "Base Gas:\nGas Price: 0.005 Gwei\nMax Fee: 0.01 Gwei"

ZYRA Payments

How to pay for AgentZyra tasks using ZYRA tokens on Base.

What is ZYRA?

ZYRA is a B20 native token on Base — an ERC-20 superset that runs as a precompile. It's cheaper and faster than standard ERC-20 tokens while keeping full compatibility. ZYRA is the native payment token for the AgentZyra platform.

Payment Flow

Every tool call requires a ZYRA payment. Here's how it works:

// Step 1: Send ZYRA to treasury
// Treasury address: from /pricing endpoint
// Chain: Base Sepolia

// Step 2: Verify payment
{
  "tool": "verify_payment",
  "params": {
    "tx_hash": "0x...",
    "wallet": "0x...",
    "tool": "research",
    "mode": "quick"
  }
}
// Response: { "payment_id": "paid_..." }

// Step 3: Use tool with payment_id
{
  "tool": "research",
  "params": {
    "query": "latest DeFi protocols",
    "depth": "quick",
    "payment_id": "paid_..."
  }
}

Pricing

MCP API Reference

Complete reference for AgentZyra's MCP server endpoints.

Endpoints

Health Check

GET https://agentzyra.com/health

// Response
{
  "status": "ok",
  "name": "agentzyra-mcp",
  "version": "1.0.0"
}

Tools Reference

Complete reference for all MCP tools exposed by AgentZyra.

verify_payment

Verify a ZYRA token payment on-chain. Returns a payment_id to use with other tools.

research

Search the web and summarize findings. Cost: 500 ZYRA (quick) / 1,500 ZYRA (deep).

web3

Query on-chain data across EVM chains. Cost: 300 ZYRA (query) / 1,000 ZYRA (analyze).

scrape

Scrape and extract content from a webpage. Cost: 500 ZYRA (text) / 1,000 ZYRA (full).

analyze

Analyze data: JSON, CSV, text. Cost: 500 ZYRA (simple) / 1,500 ZYRA (complex).

Tokenomics

ZYRA is a B20 native token on Base that powers the AgentZyra ecosystem.

Token Details

Token Distribution

Token Utility

• Access — ZYRA is required to use AgentZyra's tools (research, web3, scrape, analyze)
• Payment — Pay per tool call via x402 protocol or MCP
• Governance — Future: ZYRA holders can vote on protocol decisions
• Staking — Future: Stake ZYRA for reduced fees or priority access

Fee Structure

Treasury

All payments go to the treasury address:

0xf57b2704a4555FDc79E83DeEa884EdE0D384650a

Treasury funds are used for:

• Server infrastructure (VPS, domains, APIs)
• Development and maintenance
• Token buyback and burns (future)
• Ecosystem growth and partnerships

Frequently Asked Questions