Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions conformance/examples/agentservices/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# AgentServices — ARD Catalog Example

Real-world [Agentic Resource Discovery](https://github.com/ards-project/ard-spec) catalog from [AgentServices](https://agentservices.to), a paid API platform for AI agents.

## About

AgentServices provides 52 endpoints (12 free, 40 paid) covering:
- Crypto data (prices, indicators, DeFi yields)
- Market intelligence (portfolio analysis, market pulse, DeFi strategy)
- On-chain analytics (whale tracking, exchange flows, stablecoin flows)
- Cross-DEX arbitrage scanning
- Deep research synthesis
- AI inference (multiple LLM models)

All paid endpoints use the [x402 payment protocol](https://x402.org) — agents pay per call in USDC on Base (L2).

## Catalog

The `ai-catalog.json` in this directory is the ARD-compatible version of the catalog served live at:

```
https://agentservices.to/.well-known/ai-catalog.json
```

It declares two entries:
1. **MCP Server** — Remote MCP transport (SSE) at `https://agentservices.to/mcp` with 37+ tools
2. **REST API** — HTTP endpoints with x402 nanopayments at `https://agentservices.to`

## Key Features

- **x402-native**: Every paid endpoint returns HTTP 402 with payment-required metadata. Agents sign EIP-3009 transfers and retry with payment headers.
- **Multi-channel access**: REST API, MCP endpoint, SDK (Python), and plugin (ElizaOS)
- **Agent discovery signals**: Schema.org, llms.txt, OpenAPI spec, robots.txt, x402 manifest, and ARD catalog all served from well-known paths
65 changes: 65 additions & 0 deletions conformance/examples/agentservices/ai-catalog.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
{
"specVersion": "1.0",
"host": {
"displayName": "AgentServices",
"identifier": "did:web:agentservices.to"
},
"entries": [
{
"identifier": "urn:air:agentservices.to:server:mcp",
"displayName": "AgentServices MCP Server",
"type": "application/mcp-server-card+json",
"url": "https://agentservices.to/mcp",
"capabilities": [
"crypto_prices",
"technical_indicators",
"defi_yields",
"fear_greed",
"portfolio_intelligence",
"market_pulse",
"defi_strategy",
"onchain_overview",
"arbitrage_scanner",
"deep_research",
"search",
"ai_inference"
],
"description": "52-service paid API platform for AI agents. Data, search, market intelligence, DeFi analytics, on-chain insights, and AI inference via x402 nanopayments on Base.",
"representativeQueries": [
"what is the current price of Bitcoin and Ethereum",
"show me DeFi yields ranked by APY with risk assessment",
"analyze my crypto portfolio and give a verdict",
"scan for cross-DEX arbitrage opportunities",
"research the latest developments in AI agent infrastructure"
]
},
{
"identifier": "urn:air:agentservices.to:api:rest",
"displayName": "AgentServices REST API",
"type": "application/x402-api+json",
"url": "https://agentservices.to",
"capabilities": [
"GET /v1/prices",
"GET /v1/indicators/{symbol}",
"GET /v1/yields",
"GET /v1/fear-greed",
"GET /v1/portfolio?symbol={symbol}",
"GET /v1/market-pulse",
"GET /v1/defi-strategy",
"GET /v1/onchain-overview",
"GET /v1/arbitrage",
"GET /v1/research?q={query}",
"GET /v1/search?q={query}",
"POST /v1/inference"
],
"description": "REST API with x402 payment protocol. 52 endpoints (12 free, 40 paid at $0.01-$0.25/call). Agents discover, pay via USDC on Base, and consume in a single HTTP transaction.",
"representativeQueries": [
"get technical indicators for ETH",
"fetch the fear and greed index",
"get a comprehensive market overview",
"run deep research on a topic",
"generate a response using AI inference"
]
}
]
}
Loading