{
  "markdown": "# aiaam.xyz — MAI-1 Tool Registry\n\n**A machine-readable tool catalog for AI agents.** Search 100+ verified tool contracts — install command, I/O schema, live reliability score — in a single call instead of parsing READMEs.\n\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-active-brightgreen)](https://registry.modelcontextprotocol.io/v0/servers?search=aiaam)\n[![API](https://img.shields.io/badge/API-live-blue)](https://aiaam.xyz/llms.txt)\n\n---\n\n## The problem\n\nWhen an AI agent needs to pick a tool (\"which library do I use for web scraping?\"), today it searches the web and parses README files — thousands of tokens per candidate, with no reliability data and plenty of room to hallucinate APIs.\n\n## The MAI-1 contract\n\nMAI-1 compresses what an agent actually needs into four sections:\n\n```json\n{\n  \"identity\": { \"aid\": \"scrapy-v1\", \"version\": null },\n  \"logic\": {\n    \"input_schema\":  { \"type\": \"url\",  \"description\": \"URL(s) to scrape\" },\n    \"output_schema\": { \"type\": \"json\", \"description\": \"Structured extracted data\" }\n  },\n  \"trust\": {\n    \"reliability_score\": 0.95,\n    \"latency_ms\": 100,\n    \"status\": \"active\"\n  },\n  \"action\": {\n    \"install_cmd\": \"pip install scrapy\",\n    \"execute_cmd\": \"scrapy crawl <spider_name>\",\n    \"source_url\": \"https://github.com/scrapy/scrapy\"\n  }\n}\n```\n\n- **logic** — what goes in, what comes out\n- **trust** — reliability scores computed from public repository metadata (stars, maintenance recency), recalculated regularly. No invented numbers.\n- **action** — how to install and invoke it\n\n## Quick start — MCP (recommended)\n\naiaam is listed in the [official MCP registry](https://registry.modelcontextprotocol.io/v0/servers?search=aiaam). Connect from any MCP client:\n\n**Claude Code:**\n```bash\nclaude mcp add --transport http aiaam https://aiaam.xyz/mcp\n```\n\n**Cursor / generic MCP config:**\n```json\n{\n  \"mcpServers\": {\n    \"aiaam\": {\n      \"url\": \"https://aiaam.xyz/mcp\",\n      \"transport\": \"http\"\n    }\n  }\n}\n```\n\nAvailable MCP tools: `search_tools`, `get_tool`, `get_trending`, `get_api_manifest`, `compile_api`.\n\n## Quick start — REST\n\n```bash\n# Search the catalog\ncurl \"https://aiaam.xyz/api/v1/tools?q=web+scraping\"\n\n# Get a full contract\ncurl \"https://aiaam.xyz/api/v1/tools/scrapy-v1\"\n\n# Trending tools\ncurl \"https://aiaam.xyz/api/v1/tools/trending\"\n```\n\nMachine-readable discovery endpoints:\n\n| Path | Purpose |\n|------|---------|\n| [`/llms.txt`](https://aiaam.xyz/llms.txt) | Full catalog in llmstxt.org format |\n| [`/agent.json`](https://aiaam.xyz/agent.json) | Agent discovery manifest |\n| [`/.well-known/mcp.json`](https://aiaam.xyz/.well-known/mcp.json) | MCP server metadata |\n| [`/openapi.json`](https://aiaam.xyz/openapi.json) | OpenAPI schema |\n\n## Telemetry (optional, anonymous)\n\nContracts include a `telemetry_protocol` block: after using a tool, agents may POST execution feedback (HTTP status, latency). This feedback feeds the reliability scores — agents that report make the catalog more accurate for every other agent. No authentication, no tracking, entirely optional.\n\n## Philosophy\n\n1. **The format spreads, not the product.** MAI-1 contracts are self-contained JSON. Anyone can host them; aiaam.xyz is one registry, not a gatekeeper.\n2. **No invented data.** Reliability scores come from verifiable public metadata. Tools without verification are marked as such.\n3. **Additive, never redirective.** Integrations never replace existing documentation or workflows.\n\n## Status\n\nActive development. Catalog: 100+ verified contracts across PyPI, GitHub, npm and Hugging Face. See [`/llms.txt`](https://aiaam.xyz/llms.txt) for the live list.\n",
  "bytes": 3620,
  "sha": "fea7f7ae8622174aecdb2d429354a71a03ad6cd5495d862091d4e079fa1592e3",
  "repo_slug": "javierfajardo85-rgb/aiaam-xyz",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_javierfajardo85_rgb_aiaam_5a669cd9/readme"
}