# AGNTCY

> AGNTCY is the open collective for agent interoperability, initiated by Outshift — Cisco's incubation
> group — and governed under the Linux Foundation (LF Projects, LLC). It publishes specifications
> rather than a product API: OASF for describing agents, the Agent Directory (DIR) for announcing and
> discovering them, SLIM as a secure low-latency transport, the Agent Connect Protocol (ACP) for
> invoking remote agents, and an Identity layer for onboarding and verifying agents with Verifiable
> Credentials. Everything is Apache-2.0. There are no plans, no pricing and no paid tier.
>
> Generated by API Evangelist on 2026-08-19 from AGNTCY's own public artifacts. This is a
> third-party profile, not an AGNTCY document. AGNTCY publishes one real llms.txt of its own, for
> the Agent Directory, at https://dir.agntcy.org/llms.txt — captured verbatim in this repo as
> llms/agntcy-dir-llms.txt.

## What you can actually call

Only one AGNTCY-operated API exists. Everything else is a specification you implement, or software
you deploy yourself.

- [OASF Schema API](https://schema.oasf.outshift.com/api): live, unauthenticated, 31 operations.
  Schema browsing, taxonomy navigation, sample generation, translation and record validation.
  Version-addressed (`/api/1.1.0/...`); versions 0.7.0, 0.8.0, 1.0.0 and 1.1.0 are all still served.
- [OASF Swagger UI console](https://schema.oasf.outshift.com/doc): every operation callable from the
  browser with no credentials.
- [Health](https://schema.oasf.outshift.com/healthz): the only availability signal AGNTCY publishes.

## Specifications

- [Agent Connect Protocol (ACP) 0.2.3](https://spec.acp.agntcy.org/openapi.json): OpenAPI 3.1.1,
  30 operations over agents, threads, thread runs and stateless runs. Declares no `servers[]` — the
  base URL is the agent server implementing it.
- [OASF — Open Agentic Schema Framework](https://schema.oasf.outshift.com/): the record schema plus
  the skill, domain and module taxonomies. Released versions are immutable.
- [Agent Directory (DIR)](https://dir.agntcy.org/): gRPC, schemas on https://buf.build/agntcy/dir.
  Storage, routing, search, security, naming, sync, events, runtime discovery.
- [SLIM protocol](https://github.com/agntcy/slim-spec): Secure Low-Latency Interactive Messaging.
- [AGNTCY Identity](https://identity-docs.outshift.com/docs/intro/): Identity Service API
  (36 operations) and Identity Node API (9 operations), both OpenAPI 3.0.3, both self-hosted.

## Agent surfaces

- MCP: `dir-mcp`, 12 tools and 7 prompts over OASF schemas and the Agent Directory.
  **Local stdio only — there is no remote MCP endpoint.** `npx -y @agntcy/dir-mcp`, or
  `docker run --rm -i ghcr.io/agntcy/dir-ctl:latest mcp serve`, or `dirctl mcp serve`.
- A2A: AGNTCY ships SLIMRPC transports for the A2A SDKs in Go, JavaScript/TypeScript, Java, .NET and
  Python, and dir-mcp imports and exports A2A agent cards. AGNTCY itself serves **no**
  `/.well-known/agent-card.json` on any host.
- Agent Skills: `agntcy_oasf_export_record` converts an OASF record into a `SKILL.md`.

## Documentation

- [agntcy.org](https://agntcy.org/)
- [docs.agntcy.org](https://docs.agntcy.org/)
- [dir.agntcy.org](https://dir.agntcy.org/) — Agent Directory docs, quickstart, CLI reference
- [slim.agntcy.org](https://slim.agntcy.org/)
- [identity-docs.outshift.com](https://identity-docs.outshift.com/docs/intro/)
- [Changelog](https://agntcy.org/changelog) — every project release, dated
- [SDKs](https://agntcy.org/sdks)
- [GitHub organization](https://github.com/agntcy) — 52 public repositories
- [Discussions](https://github.com/orgs/agntcy/discussions)
- [Governance](https://github.com/agntcy/governance)

## Clients

- CLI: `dirctl` — `brew tap agntcy/dir https://github.com/agntcy/dir && brew install dirctl`
- Python: `agntcy-acp`, `agntcy-dir`, `agntcy-app-sdk`, `ioa-observe-sdk`, `agntcy-iomapper`, `slim-bindings`
- JavaScript: `@agntcy/slim-bindings`, `@agntcy/slim-a2a`, `@agntcy/dir-mcp`, `agntcy-dir`
- Go: `github.com/agntcy/dir`, `github.com/agntcy/oasf-sdk`, `github.com/agntcy/dir-mcp`
- Rust: `agntcy-slim`, `ai-catalog`
- .NET: `Agntcy.Slim`, `Agntcy.Slim.SlimRpc`, `Agntcy.SlimA2A`

## Security

- Report privately to security@agntcy.org. Policy is published as `SECURITY.md` in each repository,
  e.g. https://github.com/agntcy/dir/blob/main/SECURITY.md
- Coordination via GitHub Security Advisories; advisories announced in project release notes.
- **No `/.well-known/security.txt` is served on any AGNTCY host** (all returned 404 on 2026-08-19).

## Known gaps (measured, 2026-08-19)

- No `/.well-known/` documents of any kind on any host — no security.txt, no api-catalog, no agent card.
- No AsyncAPI, although the Directory has a real gRPC streaming event surface.
- `POST /v1/search` and `POST /v1/extract` shipped in dir v1.7.0 with no OpenAPI describing them.
- No status page (`status.agntcy.org` does not resolve), no SLA, no written deprecation policy.
- `agntcy-acp` on PyPI was last released 2025-06-16, more than a year behind every other AGNTCY SDK.

## Terms

- [Privacy policy](https://lfprojects.org/policies/privacy-policy/) (LF Projects)
- [Terms of use](https://lfprojects.org/policies/terms-of-use/) (LF Projects)
- License: Apache-2.0 across the organization