AgentTools Python Client

Self-healing reference SDK for Tools for Agents — M2M / A2A.

Install

pip install agenttools-client
# or from repo:
pip install -e ./agenttools_client

Requires Python 3.10+ and httpx.

Features

Quick start

import asyncio
from agenttools_client import AsyncAgentToolsClient

async def main():
    async with AsyncAgentToolsClient() as client:
        plan = await client.advisor("Extract markdown from a blog URL")
        page = await client.extract("https://example.com")
        chain = await client.run_chain("article_read", {"url": "https://example.com"})
        # A2A orchestrators:
        skill = await client.a2a.advisor("Summarize a PDF for RAG")

asyncio.run(main())

A2A (preferred for multi-agent orchestrators)

async with AsyncAgentToolsClient() as client:
    skills = await client.a2a.list_skills()
    result = await client.a2a.run_chain("pdf_summary", {"url": "https://example.com/x.pdf"})
    mission = await client.a2a.run_mission("Research solid-state batteries")

Agent Card: GET https://api.toolsforagents.tools/.well-known/agent-card.json

Self-healing 422

Wrong body → SDK fetches examples, picks best match for missing fields, retries once:

await client.json("POST", "/v1/conflict/detect", json={})  # auto-fixes to documents[]

Environment

Publish (maintainers)

See PUBLISH.md.

License

MIT