aid: agntcy
name: AGNTCY
description: 'AGNTCY is the open collective for agent interoperability, initiated by Outshift — Cisco''s incubation
  group — and governed under the Linux Foundation (LF Projects, LLC), developed in the open across 52 public repositories.
  It publishes specifications rather than a product API: OASF (Open Agentic Schema Framework) for describing agents
  with a versioned record schema and skill/domain taxonomies, the Agent Directory (DIR) for announcing and discovering
  multi-agent systems over gRPC, SLIM (Secure Low-Latency Interactive Messaging) as a transport, the Agent Connect
  Protocol (ACP) as a REST interface for invoking remote agents, and an Identity layer that issues and verifies
  W3C Verifiable Credential badges for agents, MCP servers and tools. One AGNTCY-operated API exists — the OASF
  Schema Server at schema.oasf.outshift.com, unauthenticated and callable by anyone; everything else is a specification
  you implement or software you deploy yourself. It ships SDKs in Python, JavaScript, Go, Rust and .NET, a local-stdio
  MCP server for the Agent Directory, and SLIMRPC transports for the A2A SDKs in five languages. Everything is Apache-2.0;
  there is no pricing, no paid tier and no commercial plan.'
url: https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/apis.yml
type: Index
access: 3rd-Party
position: Consumer
x-type: company
x-source: cisco-family-buildout:2026-08-19
x-parent: cisco
x-relationship: initiative
x-contract-status: real
x-contract-note: 'Four first-party machine-readable contracts (106 operations): the Agent Connect Protocol OpenAPI
  3.1.1, the OASF Schema API, and two AGNTCY Identity OpenAPI 3.0.3 documents, plus 34 verbatim protobuf definitions.
  schema.oasf.outshift.com is the one genuinely callable AGNTCY-hosted API.'
specificationVersion: '0.23'
created: '2026-08-19'
modified: '2026-08-19'
tags:
- AI Agents
- Interoperability
- Specification
- Open-Source
- Agent Discovery
- Identity
- Agent Directory
- MCP
- A2A
- OpenAPI
- gRPC
- Protocol Buffers
- Verifiable Credentials
- Schema
- Taxonomy
- Messaging
- Observability
- Linux Foundation
tags_raw:
- AI Agents
- Interoperability
- Specification
- Open Source
- Agent Discovery
- Identity
- Agent Directory
- Model Context Protocol
- A2A
- OpenAPI
- gRPC
- Protocol Buffers
- Verifiable Credentials
- Schema
- Taxonomy
- Messaging
- Observability
- Linux Foundation
apis:
- name: OASF Schema API
  description: 'The Open Agentic Schema Framework schema server API. Browse and retrieve the OASF schema, walk the
    skill / domain / module taxonomies, generate samples, translate taxonomy values, and validate agent records.
    Hosted by Outshift by Cisco, unauthenticated, and version-addressed: schema versions 0.7.0, 0.8.0, 1.0.0 and
    1.1.0 are all still served. This is the only AGNTCY-operated API.'
  humanURL: https://schema.oasf.outshift.com/doc
  baseURL: https://schema.oasf.outshift.com/api
  image: https://agntcy.org/logo/preview-thumbnail-new.png
  tags:
  - Schema
  - Taxonomy
  - Validation
  - AI Agents
  properties:
  - type: OpenAPI
    url: openapi/agntcy-oasf-schema-swagger.json
  - type: Swagger
    url: openapi/agntcy-oasf-schema-swagger.json
  - type: Overlay
    url: overlays/agntcy-oasf-schema-overlay.yaml
  - type: Documentation
    url: https://docs.agntcy.org/oasf/open-agentic-schema-framework/
  - type: APIReference
    url: https://schema.oasf.outshift.com/doc
  - type: Console
    url: https://schema.oasf.outshift.com/doc
  - type: SourceCode
    url: https://github.com/agntcy/oasf
  - type: JSONSchema
    url: json-schema/agntcy-oasf-record.json
  - type: Protobuf
    url: grpc/agntcy-oasf-types-v1-record.proto
  x-evidence:
    probed: '2026-08-19'
    base_status: 200
    note: GET https://schema.oasf.outshift.com/api/versions returned 200 anonymously.
- name: Agent Connect Protocol (ACP)
  description: 'A standard REST interface for invoking and configuring remote agents: agent discovery and descriptors,
    stateful threads, thread runs, and stateless runs, each with create / wait / stream / resume / cancel paths.
    OpenAPI 3.1.1, version 0.2.3, 30 operations. ACP is a specification every compliant agent server implements
    — it declares no servers[] and AGNTCY hosts no instance of it.'
  humanURL: https://spec.acp.agntcy.org/
  image: https://agntcy.org/logo/preview-thumbnail-new.png
  tags:
  - AI Agents
  - Interoperability
  - Specification
  - OpenAPI
  properties:
  - type: OpenAPI
    url: openapi/agntcy-acp-openapi.json
  - type: Overlay
    url: overlays/agntcy-acp-overlay.yaml
  - type: APIReference
    url: https://spec.acp.agntcy.org/
  - type: SourceCode
    url: https://github.com/agntcy/acp-spec
  - type: Documentation
    url: https://docs.agntcy.org/
  x-no-base-url: The ACP OpenAPI declares no servers[] block, because ACP is an interface implemented by each agent
    server rather than a service AGNTCY operates. Recorded as absent rather than guessed from the spec host.
- name: AGNTCY Identity Service API
  description: 'Manages identity and access control in the AGNTCY ecosystem: register agents, MCP servers and tools
    as apps (including directly from an OASF record), issue and verify W3C Verifiable Credential badges, manage
    policies and rules, register approval devices, and run the OIDC authorize/token and external-authorization flows.
    OpenAPI 3.0.3, 36 operations, with bearer-JWT and x-id-api-key security schemes.'
  humanURL: https://identity-docs.outshift.com/openapi/service/v1alpha1
  image: https://agntcy.org/logo/preview-thumbnail-new.png
  tags:
  - Identity
  - Verifiable Credentials
  - Authorization
  - AI Agents
  properties:
  - type: OpenAPI
    url: openapi/agntcy-identity-service-openapi.yaml
  - type: Overlay
    url: overlays/agntcy-identity-service-overlay.yaml
  - type: Documentation
    url: https://identity-docs.outshift.com/docs/intro/
  - type: APIReference
    url: https://identity-docs.outshift.com/docs/api
  - type: SourceCode
    url: https://github.com/agntcy/identity-service
  - type: Authentication
    url: authentication/agntcy-authentication.yml
  x-no-base-url: Self-hosted. The published OpenAPI declares servers[] http://localhost:4000 and no AGNTCY-operated
    instance exists — identity-service.outshift.com, referenced in the docs sitemap, does not resolve (DNS failure)
    as of 2026-08-19.
- name: AGNTCY Identity Node API
  description: The identity node that generates and resolves agent IDs, registers issuers and serves their JWKS,
    and publishes, revokes, searches and verifies Verifiable Credentials. OpenAPI 3.0.3, 9 operations, generated
    from the protobuf service definitions.
  humanURL: https://github.com/agntcy/identity
  image: https://agntcy.org/logo/preview-thumbnail-new.png
  tags:
  - Identity
  - Verifiable Credentials
  - JWKS
  - AI Agents
  properties:
  - type: OpenAPI
    url: openapi/agntcy-identity-node-openapi.yaml
  - type: Overlay
    url: overlays/agntcy-identity-node-overlay.yaml
  - type: SourceCode
    url: https://github.com/agntcy/identity
  - type: Protobuf
    url: grpc/agntcy-identity-node-v1alpha1-id_service.proto
  - type: JSONSchema
    url: json-schema/agntcy-identity-credential-content.jsonschema.json
  x-no-base-url: Self-hosted. The published OpenAPI declares servers[] http://0.0.0.0:4000 (local environment);
    AGNTCY operates no node.
- name: Agent Directory (DIR)
  description: Distributed announce and discovery of multi-agent systems. gRPC-first, with services for storage
    (content-addressed by CID), routing over a DHT, structured search, signing and verification, domain name verification,
    peer sync, streaming events and runtime discovery. Canonical schemas are published on buf.build.
  humanURL: https://dir.agntcy.org/
  image: https://agntcy.org/logo/preview-thumbnail-new.png
  tags:
  - Agent Discovery
  - gRPC
  - Protocol Buffers
  - AI Agents
  properties:
  - type: Protobuf
    url: grpc/_index.yml
  - type: APIReference
    url: https://dir.agntcy.org/latest/dir/dir-api-reference/
  - type: Documentation
    url: https://dir.agntcy.org/
  - type: GettingStarted
    url: https://dir.agntcy.org/latest/dir/dir-quickstart/
  - type: SourceCode
    url: https://github.com/agntcy/dir
  - type: BufRegistry
    url: https://buf.build/agntcy/dir
  - type: LLMsTxt
    url: llms/agntcy-dir-llms.txt
  - type: MCPServer
    url: mcp/agntcy-mcp.yml
  - type: ToolCrosswalk
    url: mcp/agntcy-tool-crosswalk.yml
  - type: CLI
    url: cli/agntcy-cli.yml
  x-no-base-url: Self-hosted gRPC. dirctl defaults to 0.0.0.0:8888 for a local node; remote access goes through
    an operator-run oidc-gateway. AGNTCY publishes no public Directory endpoint.
common:
- type: AgenticAccess
  url: agentic-access/agntcy-agentic-access.yml
- type: DomainSecurity
  url: security/agntcy-domain-security.yml
- type: Authentication
  url: authentication/agntcy-authentication.yml
- type: ParentCompany
  url: https://apis.io/providers/cisco/
  name: Cisco
  x-relationship: initiative
  x-generated-by: cisco-family:2026-08-19
- type: Portal
  url: https://agntcy.org/
- type: Documentation
  url: https://docs.agntcy.org/
- type: APIReference
  url: https://docs.agntcy.org/
- type: GitHubOrganization
  url: https://github.com/agntcy
- type: MCPServer
  url: https://github.com/agntcy/dir-mcp
- type: Website
  url: https://outshift.cisco.com/
- type: GitHubOrganization
  url: https://github.com/CiscoDevNet
- type: LLMsTxt
  url: llms/agntcy-llms.txt
- type: Packages
  url: packages/agntcy-packages.yml
- type: SDKs
  url: packages/agntcy-packages.yml
- type: MCPServer
  url: mcp/agntcy-mcp.yml
- type: ToolCrosswalk
  url: mcp/agntcy-tool-crosswalk.yml
- type: Overlay
  url: overlays/agntcy-acp-overlay.yaml
- type: Protobuf
  url: grpc/_index.yml
- type: Conformance
  url: conformance/agntcy-conformance.yml
- type: ErrorCatalog
  url: errors/agntcy-problem-types.yml
- type: Lifecycle
  url: lifecycle/agntcy-lifecycle.yml
- type: VulnerabilityDisclosure
  url: security/agntcy-vulnerability-disclosure.yml
- type: Security
  url: https://github.com/agntcy/dir/blob/main/SECURITY.md
- type: Sandbox
  url: sandbox/agntcy-sandbox.yml
- type: Console
  url: https://schema.oasf.outshift.com/doc
- type: Conventions
  url: conventions/agntcy-conventions.yml
- type: Idempotency
  url: conventions/agntcy-conventions.yml
- type: ChangeLog
  url: changelog/agntcy-changelog.yml
- type: ChangeLog
  url: https://agntcy.org/changelog
- type: CLI
  url: cli/agntcy-cli.yml
- type: DataModel
  url: data-model/agntcy-data-model.yml
- type: AgentSkill
  url: skills/_index.yml
- type: RateLimits
  url: rate-limits/agntcy-rate-limits.yml
- type: Plans
  url: plans/agntcy-plans-pricing.yml
- type: JSONSchema
  url: json-schema/agntcy-oasf-record.json
- type: DeveloperPortal
  url: https://agntcy.org/
- type: GettingStarted
  url: https://dir.agntcy.org/latest/dir/dir-quickstart/
- type: Support
  url: https://github.com/orgs/agntcy/discussions
- type: Community
  url: https://join.slack.com/t/agntcy/shared_invite/zt-3xozr6nzq-i6LXv2P8l2kVW4_Prnny2w
- type: Blog
  url: https://agntcy.org/articles
- type: TermsOfService
  url: https://lfprojects.org/policies/terms-of-use/
- type: PrivacyPolicy
  url: https://lfprojects.org/policies/privacy-policy/
- type: SourceCode
  url: https://github.com/agntcy
- type: Governance
  url: https://github.com/agntcy/governance
- type: License
  url: https://www.apache.org/licenses/LICENSE-2.0
- type: Video
  url: https://www.youtube.com/playlist?list=PL49BrgsjXg5qVeRVqlX9O74W02q3c8fow
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
image: https://agntcy.org/logo/preview-thumbnail-new.png
x-enrichment:
  date: '2026-08-19'
  status: enriched
  artifacts_added: 78
  pass: local-v1