Skip to content

agents.md (AAIF format) — agent-facing integration manifest #20

Description

@dzuluaga

Add an agents.md (AAIF format) — an agent-facing integration manifest for AttestoMCP, the agentic counterpart to the human README, alongside the discovery surface that already ships (llms.txt + /.well-known/attestomcp.json).

Why

AttestoMCP is agent-native. An agents.md in the AAIF (AI Agent Interoperability Foundation) format gives a coding/host agent a structured, machine-readable description of how to integrate the gate: what attestomcp.mount(app) does, the policy API (requirements(), required/optional, built-in + custom credentials), and the runtime endpoints. It pairs directly with the install skill (#17), which would consume it.

Scope

  • Author agents.md per the AAIF schema (link the reference spec in the PR).
  • Cover: install, mount(), the gate policy surface, discovery endpoints, the security-bypass-test expectation.
  • Placement: library repo root (canonical); optionally surfaced from the site.

Note

Emerging convention — confirm the current AAIF agents.md schema before authoring (Diego/Ever to provide the reference).

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    Status
    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions