Skip to main content

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

pip install agent-interface-standard
{"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

{
  "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

Metadata

Release files for agent-interface-standard 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-interface-standard 0.1.0
File Size Uploaded
agent_interface_standard-0.1.0.tar.gz 5.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-interface-standard 0.1.0
File Interpreter ABI Platform
agent_interface_standard-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.4 kB

Release files / agent_interface_standard-0.1.0.tar.gz

Download URL agent_interface_standard-0.1.0.tar.gz
Size 5.7 kB
Tags Source
SHA-256 checksum
How to use checksums
4568fe4154e01999d4fe33a2e33765b1e0b4a30e138c9d5386918633f56064c1
BLAKE2b-256 checksum
How to use checksums
875755e846f7890d299c2ade312fa36d6a1dd6838168f2367a5fcbd56ea969cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / agent_interface_standard-0.1.0-py3-none-any.whl

Download URL agent_interface_standard-0.1.0-py3-none-any.whl
Size 7.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
49d4ccd201ec610784ea40464751052c15d1c879c97d22831f36e3f939e971bc
BLAKE2b-256 checksum
How to use checksums
c6b281c54f79c69ddc6007decee67fbf71ca647b8acdf6febcf1f644cb10a695
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page