Metadata-Version: 2.4
Name: agent-interface-standard
Version: 0.1.0
Summary: Schema.org for AI agents — the open standard for how businesses describe their services to AI agents
Project-URL: Homepage, https://github.com/AiAgentKarl/agent-interface-standard
Project-URL: Repository, https://github.com/AiAgentKarl/agent-interface-standard
Author: AiAgentKarl
License: MIT
Keywords: agent-interface,ai-agents,business,mcp,protocol,schema,standard
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# Agent Interface Standard 🌐

**Schema.org for AI Agents** — the open standard for how businesses describe their services to AI agents.

## The Vision

Schema.org made websites machine-readable for search engines. **Agent Interface Standard** makes businesses machine-readable for AI agents.

Businesses publish a simple JSON spec at `/.well-known/agent-interface.json` describing what services they offer and how agents can interact with them.

## Installation

```bash
pip install agent-interface-standard
```

```json
{"mcpServers": {"agent-interface": {"command": "uvx", "args": ["agent-interface-standard"]}}}
```

## Tools

| Tool | Description |
|------|-------------|
| `get_spec_template` | Get a blank template to fill out |
| `get_example_spec` | See a complete example (restaurant) |
| `validate_interface_spec` | Check your spec for errors |
| `register_business` | Register a business in the directory |
| `search_businesses` | Find agent-accessible businesses |
| `get_business_capabilities` | See what a business offers |
| `fetch_remote_spec` | Fetch a spec from a URL |

## The Spec Format

```json
{
  "agent_interface": "0.1.0",
  "business": {
    "name": "My Business",
    "description": "What we do",
    "category": "e_commerce"
  },
  "capabilities": [
    {
      "name": "search_products",
      "description": "Search our product catalog",
      "type": "search",
      "endpoint": "https://api.mybusiness.com/search",
      "method": "GET",
      "parameters": [...]
    }
  ],
  "auth": {"type": "api_key"},
  "pricing": {"model": "freemium"}
}
```

## Why This Matters

When AI agents become primary customers (not just humans), businesses need a standard way to be "agent-accessible." This is that standard.

## License

MIT
