Agent Discovery

AIsa publishes machine-readable discovery files so autonomous agents can find, authenticate with, and call our APIs without human intervention. Developers can use the same files to auto-generate clients and explore endpoints.

https://aisa.one/.well-known/agent-card.json
A2A compatible·OpenAI plugin compatible·MCP manifest·OpenAPI 3.1·llms.txt

Six Ways to Discover AIsa

A2A Agent Card

/.well-known/agent-card.json

Google A2A protocol standard. Declares AIsa's skills, authentication, and capabilities for autonomous agent-to-agent discovery.

AI Plugin Manifest

/.well-known/ai-plugin.json

ChatGPT-era plugin standard. Provides model-facing descriptions and links to the OpenAPI spec for agent frameworks.

MCP Discovery Manifest

/.well-known/mcp.json

Model Context Protocol manifest — one MCP server entry per skill, with transport, auth, capabilities, and tool surface. The desktop-agent surface (Claude Desktop, IDE runtimes).

OpenAPI 3.1 Spec

/openapi.yaml

Full machine-readable API specification with request/response schemas and authentication details.

llms.txt

/llms.txt

Concise product discovery and recommendation map for AIsa capabilities, interfaces, and evaluation resources.

llms-full.txt

/llms-full.txt

Full product context for recommendation, evaluation, architecture, security, pricing, use cases, and machine discovery. Technical details remain in /docs/llms-full.txt.

Search Advertised Capabilities

43 capabilities advertised through the A2A Agent Card: 42 installable skills plus the core AI Model Inference capability. Agents use these same tags for programmatic discovery.

AI Model Inference

chat-completions

Access 50+ LLMs from OpenAI, Anthropic, Google, DeepSeek, and more via an OpenAI-compatible /v1/chat/completions endpoint. Supports text, vision, coding, reasoning, creative writing, and translation models.

inferencellmai-modelstext-generation+2

SEO Keyword Research

seo-keyword-research

Build SEO keyword strategies from a site, product, market, or competitor set with crawl context, DataForSEO metrics, SERP evidence, and AIsa LLM clustering.

seokeyword-researchdataforseomarketing+1

KOL Creator Discovery

kol-creator-discovery

Turn one YouTube, TikTok, or Instagram creator profile into an outreach-ready list with verified contact emails and closely matched creators.

kolinfluencer-marketingcreator-discoveryemail-lookup+1

Trend Forecast

trend-forecast

Forecast trends by combining prediction markets, X/Twitter sentiment, news velocity, financial market data, and LLM synthesis.

forecastprediction-marketstwitternews+2

Twitter Autopilot

twitter-autopilot

Twitter/X intelligence and automation for autonomous agents. Read, search, engage, write, and post (text & media) on Twitter/X.

social-mediatwitterxsearch+2

MarketPulse

marketpulse

Query real-time and historical financial data for equities — prices, news, financial statements, metrics, analyst estimates, insider/institutional activity, SEC filings, earnings press releases, segmented revenues, stock screening, and macro interest rates.

financestocksequitiesmarket-data+2

Crypto Market Data

crypto-market-data

Real-time and historical cryptocurrency market data via CoinGecko: prices, market-cap rankings, charts, OHLC candles, token lookup, exchanges, categories, trending searches, and news.

cryptocoingeckomarket-dataprices+2

Prediction Market Data

prediction-market-data

Prediction markets data — Polymarket, Kalshi markets, prices, positions, and trades.

prediction-marketspolymarketkalshitrading+1

Prediction Market Arbitrage

prediction-market-arbitrage

Find and analyze arbitrage opportunities across prediction markets.

arbitrageprediction-marketstradinganalysis

Multi-source Search

multi-source-search

Intelligent search for autonomous agents with structured retrieval plus Perplexity Sonar answer endpoints.

searchweb-searchacademic-searchresearch+1

Perplexity Search

perplexity-search

Perplexity Sonar search and answer generation through AIsa.

searchperplexitysonaranswers+1

YouTube SERP

youtube-serp

YouTube SERP for autonomous agents. Search top-ranking videos, channels, and trends.

youtubevideo-searchsocial-mediaserp

Media Gen

media-gen

Generate images & videos with a single AIsa API key. 4 image models across 3 endpoints, 4 Wan video variants.

image-generationvideo-generationcreativeai-art+3

Last 30 Days

last30days

Multi-source research brief covering the last 30 days. Aggregates web, news, social, and financial signals into a single report.

researchnewsaggregationanalysis+1

AIsa Provider for OpenClaw

aisa-provider

Configure OpenClaw to use AIsa as its model provider for Chinese and global LLM workflows.

aisaproviderai

AIsa Tavily Search

aisa-tavily

Search the web and extract public page content for source discovery, current news lookup, and research workflows.

aisatavilysearch-research

AIsa Twitter API Command Center

aisa-twitter-api

Search, monitor, and post on X/Twitter through read, OAuth, and approved publishing workflows.

aisatwitterapisocial

AIsa Twitter Command Center

aisa-twitter-command-center

Search X/Twitter profiles, timelines, tweets, trends, lists, communities, and Spaces for social research.

aisatwittercommandcenter+1

AIsa Twitter Post Engage

aisa-twitter-post-engage

Search X/Twitter and perform approved posting, liking, following, and unfollowing workflows.

aisatwitterpostengage+1

AIsa YouTube Search

aisa-youtube-search

Search YouTube videos, channels, and playlists for video research and discovery.

aisayoutubesearchsocial

AIsa CN-LLM

cn-llm

Route Chinese-language prompts to Chinese LLMs such as Qwen, DeepSeek, GLM, and Baichuan.

cnllmai

Last 30 Days ZH

last30days-zh

Research the last 30 days of signals across web, X, YouTube, Polymarket, and social sources in Chinese workflows.

last30dayszhsearch-research

AIsa LLM Router

llm-router

Route prompts across GPT, Claude, Gemini, Qwen, DeepSeek, Grok, and other supported models.

llmrouterai

AIsa Market

market

Retrieve stock, crypto, financial statement, news, analyst, insider, and macro market data for analysis.

marketdata-finance

AIsa Multi-Source Search

multi-search

Search across web, academic, smart search, Tavily, and research-answer sources for stronger coverage.

multisearchsearch-research

AIsa Perplexity Deep Research

perplexity-research

Generate citation-backed research answers using Perplexity Sonar models.

perplexityresearchsearch-research

Prediction Market Arbitrage ZH

prediction-market-arbitrage-zh

Find cross-platform prediction market price differences and potential arbitrage opportunities.

predictionmarketarbitragezh+1

Prediction Market Data ZH

prediction-market-data-zh

Query Polymarket and Kalshi prices, order books, positions, trades, and wallet metrics.

predictionmarketdatazh+1

AIsa Scholar Search

scholar-search

Search academic papers and scholarly sources for research tasks.

scholarsearchsearch-research

AIsa Smart Search

smart-search

Run hybrid search that combines web and scholarly sources for broader research coverage.

smartsearchsearch-research

Stock & Crypto Analysis

stock-analysis

Analyze stocks and crypto assets with scoring, risk flags, entry levels, targets, and stop levels.

stockanalysisdata-finance

Dividend Analysis

stock-dividend

Analyze dividend yield, payout safety, growth, income quality, and dividend track records.

stockdividenddata-finance

Hot Scanner

stock-hot

Find high-momentum stocks and crypto assets, market movers, catalysts, and watchlist candidates.

stockhotdata-finance

Portfolio Management

stock-portfolio

Track portfolio positions, allocation, and live profit and loss for stocks and crypto assets.

stockportfoliodata-finance

Rumor Scanner

stock-rumors

Scan for early market signals such as M&A rumors, insider activity, analyst changes, and regulatory news.

stockrumorsdata-finance

Watchlist Management

stock-watchlist

Manage a stock and crypto watchlist with price targets, stops, and alert checks.

stockwatchlistdata-finance

AIsa Tavily Extract

tavily-extract

Extract clean readable content from public URLs for article, document, and source analysis.

tavilyextractsearch-research

AIsa Tavily Search

tavily-search

Search the web with configurable depth, topic filters, time ranges, and domain filters.

tavilyweb-searchnewssearch-research

AIsa Twitter Command Center

twitter-command-center-search-post

Search X/Twitter and publish approved posts through OAuth-backed workflows.

twittercommandcentersearch+2

US Stock Analyst

us-stock-analyst

Create US stock analysis reports using financial data, news, filings, sentiment, and AI synthesis.

usstockanalystdata-finance

AIsa Web Search

web-search

Search current web sources and return structured results with titles, URLs, and snippets.

websearchsearch-research

X Intelligence Automation

x-intelligence-automation

Search X/Twitter and run approved engagement workflows for likes, follows, unfollows, and posts.

xintelligenceautomationsocial

YouTube Search

youtube-search

Search YouTube videos, channels, and playlists for content research, trend discovery, competitor tracking, and topic exploration.

youtubesearchsocial-mediaautomation

Showing 43 of 43 capabilities

Agent-to-Agent Integration Flow

01

Discover

Your agent fetches the agent card from the well-known URL. It learns what AIsa can do, how to authenticate, and which skills are available.

02

Authenticate

The agent card declares Bearer token auth. Your agent includes the API key in the Authorization header — no OAuth flows needed.

03

Execute

Your agent selects the right skill based on tags and descriptions, constructs the API call using the OpenAPI spec, and executes autonomously.

Integrate in Minutes

$Fetch the Agent Card

bash
# 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

pyPython — Discover & Call

python
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"])

tsTypeScript — Discover & Call

typescript
// 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);

MCP Server Configuration

Connect AIsa as an MCP server in Claude Desktop, Cursor, or any MCP-compatible client.

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

Ready to Build?

Get your API key and start integrating AIsa into your agent workflows. Pay per call, no subscriptions.