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.
AGNTCY publishes 21 API contracts indexed on the APIs.io network, including Agents API, App Service API, Badge Service API, and 18 more. Tagged areas include AI Agents, Interoperability, Specification, Open Source, and Agent Discovery.
The AGNTCY catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.
AGNTCY’s developer surface includes authentication, developer portal, documentation, API reference, sandbox, developer console, changelog, and 43 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/agntcy/"><img src="https://apis.io/badge/agntcy/card.svg" alt="AGNTCY on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
A2A Agent Card+8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples+7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Protected Resource Metadata+5 pts — a served /.well-known/oauth-protected-resource carrying `resource` (documented), and naming its authorization_servers (verified)
Agentic Commerce Well-Known Document+5 pts — a parsing /.well-known/ucp.json or acp.json declaring a version and at least one service, OR (0.27) a live x402 payment challenge from _data/x402-adoption.json — `self` when its endpoints are on the provider's own domain, `platform` when they are on a vendor's
3 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
Access Clarityscores 21.1 — up to +15.8 composite points
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
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 v...
Agents are AI workflows that can be configured and/or executed on this server. This means that a client of this server can start a Run on any of the Agents supported by this ser...
A Run represents an execution of an agent. The output of a Run can be a final result or an interrupt. Result from a run can be retrieved by polling or by blocking and waiting fo...
Thread Runs are runs created on a thread. A Thread Run can be created on a thread **only** if there is no run in the `pending` status on the same thread, i.e. if the thread is i...
If supported by the involved agents, Run can be grouped in Threads. When a run is executed on a thread is called Thread Run. At the end of a Thread Run, the server keeps a threa...
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
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
deliveryModel:
model: saas
license_evidence:
not_product:
- agntcy/acp-spec
- agntcy/dir
- agntcy/identity
- agntcy/identity-service
- agntcy/oasf
open_source: unknown
commercial: true
callable_host: false
label: Hosted service · you call their endpoint
confidence: low
source:
- openapi
- pricing
- repository-not-product
generated: '2026-09-25'
method: derived
accessModel:
pricing: unknown
onboarding: unknown
trial: false
try_now: false
public: false
label: Unknown
confidence: low
source:
- authentication
- rate-limits
- security
- sandbox
generated: '2026-11-06'
method: derived
position: Consuming
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'
x-docs-platform: mkdocs
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-17
x-docs-hosting: github-pages
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
- Open-Source
apis:
- 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.
- aid: agntcy:agntcy-agents-api
name: AGNTCY Agents API
description: "Agents are AI workflows that can be configured and/or executed on this server. This means that a client of\
\ this server can start a Run on any of the Agents supported by this server.\nEach agent may support different features\
\ of ACP, also each agent specifies the schemas of the objects carried by ACP for configuration, input, output, interrupts\
\ and state. \nDetails of the ACP features and the schemas are kept in the ACP descriptor of the specific agent. This\
\ object can be retrieved through this ACP interface or is found in the ACP extension of the agent record in the agent\
\ directory.\nSee `Agent` and `AgentACPDescriptor` models below for more info."
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Agents
properties:
- type: OpenAPI
url: openapi/agntcy-agents-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-appservice-api
name: AGNTCY App Service API
description: AppService manages apps.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- App Service
tags_raw:
- AppService
properties:
- type: OpenAPI
url: openapi/agntcy-appservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-badgeservice-api
name: AGNTCY Badge Service API
description: BadgeService manages badges.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- BadgeService
properties:
- type: OpenAPI
url: openapi/agntcy-badgeservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-classes-and-objects-api
name: AGNTCY Classes and Objects API
description: The Classes and Objects API from AGNTCY — 4 operation(s) for classes and objects.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Classes and Objects
properties:
- type: OpenAPI
url: openapi/agntcy-classes-and-objects-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-deviceservice-api
name: AGNTCY Device Service API
description: DeviceService manages device.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- DeviceService
properties:
- type: OpenAPI
url: openapi/agntcy-deviceservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-idservice-api
name: AGNTCY ID Service API
description: IdService is the service that provides ID operations.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- IdService
properties:
- type: OpenAPI
url: openapi/agntcy-idservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-issuerservice-api
name: AGNTCY Issuer Service API
description: IssuerService is the service that provides ISSUER node operations.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- IssuerService
properties:
- type: OpenAPI
url: openapi/agntcy-issuerservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-json-schema-api
name: AGNTCY JSON Schema API
description: The JSON Schema API from AGNTCY — 4 operation(s) for json schema.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- JSON Schema
tags_raw:
- JSON Schema
- JSON-Schema
properties:
- type: OpenAPI
url: openapi/agntcy-json-schema-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-policyservice-api
name: AGNTCY Policy Service API
description: PolicyService manages policy.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- PolicyService
properties:
- type: OpenAPI
url: openapi/agntcy-policyservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-sample-data-api
name: AGNTCY Sample Data API
description: The Sample Data API from AGNTCY — 4 operation(s) for sample data.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Sample Data
properties:
- type: OpenAPI
url: openapi/agntcy-sample-data-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-schema-api
name: AGNTCY Schema API
description: The Schema API from AGNTCY — 8 operation(s) for schema.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Schema
properties:
- type: OpenAPI
url: openapi/agntcy-schema-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-settingsservice-api
name: AGNTCY Settings Service API
description: SettingsService manages settings.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- SettingsService
properties:
- type: OpenAPI
url: openapi/agntcy-settingsservice-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-stateless-runs-api
name: AGNTCY Stateless Runs API
description: 'A Run represents an execution of an agent.
The output of a Run can be a final result or an interrupt.
Result from a run can be retrieved by polling or by blocking and waiting for the result.
See `Run` and `RunOutput` models below for more info.'
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Stateless Runs
properties:
- type: OpenAPI
url: openapi/agntcy-stateless-runs-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-taxonomy-api
name: AGNTCY Taxonomy API
description: The Taxonomy API from AGNTCY — 3 operation(s) for taxonomy.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Taxonomy
properties:
- type: OpenAPI
url: openapi/agntcy-taxonomy-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-thread-runs-api
name: AGNTCY Thread Runs API
description: "Thread Runs are runs created on a thread. \nA Thread Run can be created on a thread **only** if there is no\
\ run in the `pending` status on the same thread, i.e. if the thread is in the state `idle`\nNote that runs over the same\
\ thread can be executed on different agents, as long as the agents support the same thread state format.\nSee `Thread`\
\ and `RunCreateStateful` for more info."
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Thread Runs
properties:
- type: OpenAPI
url: openapi/agntcy-thread-runs-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-threads-api
name: AGNTCY Threads API
description: "If supported by the involved agents, Run can be grouped in Threads. \nWhen a run is executed on a thread is\
\ called Thread Run. At the end of a Thread Run, the server keeps a thread state associated to the thread.\nA thread keeps\
\ track of agent states at every step so that continuity of the context is preserved. Moreover, such a book-keeping enables\
\ us some granular controls like debugging, interrupting or replaying a run/invocation.\n\nA thread state is a data context\
\ defined by the developer and can be anything and it gets passed through from one invocation to another so that business\
\ logic is instrumented by data.\n\nA thread keeps track of the whole state history. At every step, it also applies a\
\ checkpoint, which is primarily a `uuid`, so that it is easier to refer to a chunk of the history.\n\nOne can easily\
\ query the last state, a specific state (by checkpoint id), the whole state history, or, a part of the history (from\
\ a checkpoint).\n\nSee `Thread`, `ThreadState` and `Checkpoint` models below for more info."
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Threads
properties:
- type: OpenAPI
url: openapi/agntcy-threads-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
- type: APIReference
url: https://spec.acp.agntcy.org/
- type: SourceCode
url: https://github.com/agntcy/acp-spec
- type: Documentation
url: https://docs.agntcy.org/
- 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
- 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
- aid: agntcy:agntcy-translation-api
name: AGNTCY Translation API
description: The Translation API from AGNTCY — 4 operation(s) for translation.
humanURL: https://schema.oasf.outshift.com/doc
baseURL: https://schema.oasf.outshift.com/api
tags:
- Translation
properties:
- type: OpenAPI
url: openapi/agntcy-translation-api-openapi.yml
- type: Swagger
url: openapi/_original/agntcy-oasf-schema-swagger.json
- 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
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://artifacts.apis.io/agntcy/apis.yml
AGNTCY API — frequently asked questions
Does AGNTCY have an API?
Yes. APIs.io lists 21 APIs from AGNTCY, including Agent Directory (DIR), AGNTCY Agents API and AGNTCY App Service API, and 18 more.
Is there an OpenAPI specification for the AGNTCY API?
Yes. APIs.io indexes 20 OpenAPI specifications for AGNTCY, each linked for download from this page.
How do I authenticate with the AGNTCY API?
AGNTCY uses bearer-token authentication (apiKey/http/openIdConnect/mutualTLS/none · 2 schemes). The details are profiled on APIs.io as Agntcy Authentication.
Does AGNTCY have an MCP server?
Yes. APIs.io lists 2 MCP servers for AGNTCY: Local (stdio) MCP server requiring OAuth; 12 tools listed.
Is the AGNTCY API ready for AI agents?
AGNTCY has a Kin Score of 51.8 out of 100 (developing) and an Agent Readiness score of 42.5 (agent-native), scored by API Evangelist on 2026-11-06.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.