Agent Discovery

# Fetch the agent card to discover AIsa's capabilities
curl -s https://aisa.one/.well-known/agent-card.json | jq .

# Response includes:
# - name, description, provider info
# - authentication requirements (Bearer token)
# - skills array with IDs, descriptions, tags, and examples
# - supported input/output modes

import httpx

# Step 1: Discover AIsa's capabilities via A2A agent card
agent_card = httpx.get("https://aisa.one/.well-known/agent-card.json").json()

print(f"Agent: {agent_card['name']}")
print(f"Auth: {agent_card['authentication']['schemes']}")
print(f"Skills: {len(agent_card['skills'])} available")

for skill in agent_card["skills"]:
    print(f"  - {skill['name']}: {skill['description'][:80]}...")

# Step 2: Use a discovered skill (e.g., chat completions)
response = httpx.post(
    f"{agent_card['url']}/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_AISA_API_KEY"},
    json={
        "model": "claude-sonnet-4-20250514",
        "messages": [{"role": "user", "content": "Hello from an autonomous agent!"}]
    }
)
print(response.json()["choices"][0]["message"]["content"])

// Agent-to-Agent discovery and integration with AIsa
const AGENT_CARD_URL = "https://aisa.one/.well-known/agent-card.json";

interface AgentSkill {
  id: string;
  name: string;
  description: string;
  tags: string[];
  examples: string[];
}

interface AgentCard {
  name: string;
  url: string;
  authentication: { schemes: string[] };
  skills: AgentSkill[];
}

// Step 1: Discover the agent's capabilities
const card: AgentCard = await fetch(AGENT_CARD_URL).then(r => r.json());

// Step 2: Find a skill by tag
const searchSkill = card.skills.find(s => s.tags.includes("web-search"));

if (searchSkill) {
  console.log(`Found skill: ${searchSkill.name}`);
  console.log(`Description: ${searchSkill.description}`);
}

// Step 3: Call the discovered API
const result = await fetch(`${card.url}/apis/v1/tavily/search`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_AISA_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "latest AI agent frameworks 2026",
    topic: "news",
    max_results: 5
  })
}).then(r => r.json());

console.log(result);

{
  "mcpServers": {
    "aisa": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-remote", "https://aisa.one/docs/mcp"],
      "env": {
        "AISA_API_KEY": "your-api-key-here"
      }
    }
  }
}