Build with AgentZyra.

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 on-chain 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 on-chain token info on Base
{
  "tool": "web3",
  "params": {
    "action": "token_info",
    "chain": "base",
    "token": "on-chain"
  }
}

// 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"

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).

Frequently Asked Questions