io.github.javierfajardo85-rgb/aiaam

Official6 tools

by javierfajardo85-rgb · Python

MAI-1 registry: search 100+ verified AI tool contracts with live reliability scores in one call.

Search verified AI tool contracts with live reliability scores in a single query.

Topics

ai-agentsfastapillm-toolsmcpmcp-servertool-discoveryagent-toolsmodel-context-protocol

Captured live from the server via tools/list.

contribute_tool

Add a missing tool to the aiaam.xyz catalog. Provide its PyPI project or GitHub repo URL; the registry builds an unverified MAI-1 contract from public metadata only (no invented data). Idempotent — if the tool already exists, its current contract is returned. Use this when search_tools returns no results for a library you know exists.

Parameters (1)

source_urlstringrequired
https://pypi.org/project/<pkg> or https://github.com/<owner>/<repo>

search_tools

Search the aiaam.xyz catalog of 100+ verified MAI-1 tool contracts by capability or name. Returns up to 10 results saving ~85% context tokens vs reading raw GitHub READMEs.

Parameters (2)

querystringrequired
Tool capability or name to search (e.g. 'web scraping', 'langchain')
categorystring
Optional: filter by source platform — github | pypi | huggingface | npm

get_tool

Returns the complete MAI-1 contract for a specific tool by its AID string (e.g. 'langchain-v1', 'crewai-v1'). Includes reliability_score, latency_ms, install_cmd, execute_cmd, input/output schemas.

Parameters (1)

aidstringrequired
The tool's unique AID string identifier (e.g. 'langchain-v1')

get_trending

Returns top tools sorted by reliability_score descending. Use to discover the most reliable and actively maintained tools in the catalog.

Parameters (1)

limitinteger
Number of results to return (default 10, max 20)

get_api_manifest

Returns a compact MAI-API manifest for a web API service (Stripe, Slack, GitHub, etc.). Each manifest is ~850 tokens and contains the base URL, auth method, and up to 20 key endpoints. Use this instead of fetching and parsing a full OpenAPI spec. Available services include: stripe_api, slack_web_api, github, openai_api, notion_api, jira_cloud_rest_api, gmail_api, google_calendar_api, twilio_api, sendgrid_email_activity_api, spotify_web_api, twitter_api_v2, and 30+ more. Returns {error: not_found} if the service has not been compiled yet.

Parameters (1)

service_namestringrequired
The service identifier, e.g. 'stripe_api', 'slack_web_api', 'openai_api'. Use underscores, lowercase. Check /llmo-apis for the full list.

compile_api

Compiles a public OpenAPI/Swagger spec URL into a compact MAI-API manifest. Requires a valid API key (X-Api-Key). Without a key, only specs from apis.guru or raw.githubusercontent.com are accepted. Returns immediately with a status_url to poll for the result (~15 seconds). Use get_api_manifest to fetch the result once ready.

Parameters (3)

openapi_urlstringrequired
Public URL of an OpenAPI 3.x or Swagger 2.x JSON/YAML spec.
categorystring
Category hint: payments, communication, devtools, ai, productivity, security, data, other
api_keystring
Optional API key for unrestricted URL access. Without key, only apis.guru and github raw URLs are allowed.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "aiaam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://aiaam.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.