How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Stacklok

Stacklok registry API

The registry API from Stacklok — 10 operation(s) for registry.

Provider Profile APIs.io OpenAPI GitHub

Stacklok registry API is one of 13 APIs that Stacklok publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Registry. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 13 operations across 10 paths, and defines 43 schemas. It is described by OpenAPI 3.2.0, at version 0.1.

13 operations 10 paths 43 schemas 1 DELETE7 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1
Authentication
API Key
Contact
https://github.com/stacklok/toolhive
License
Apache 2.0
Resource Areas
1

Authentication & Security 1

Stacklok registry API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (BearerAuth).

  • BearerAuth — OAuth 2.0 Bearer token authentication. Format: "Bearer {token}"

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 1 DELETE, 7 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

registry 13
GET
/registry/{registryName}/v0.1/servers
List servers in specific registry
5 params → 200400401404
GET
/registry/{registryName}/v0.1/servers/{serverName}/versions
List all versions of an MCP server in specific registry
2 params → 200400401404
GET
/registry/{registryName}/v0.1/servers/{serverName}/versions/{version}
Get specific MCP server version in specific registry
3 params → 200400401404
GET
/api/v1beta/registry
List registries
→ 200
POST
/api/v1beta/registry
Add a registry
body → 501
DELETE
/api/v1beta/registry/{name}
Remove a registry
1 param → 204403404
GET
/api/v1beta/registry/{name}
Get a registry
1 param → 200404
PUT
/api/v1beta/registry/{name}
Update registry configuration
1 param body → 200400403404502504
POST
/api/v1beta/registry/{name}/refresh
Refresh registry cache
1 param → 200404500503
GET
/api/v1beta/registry/{name}/servers
List servers in a registry
1 param → 200404
GET
/api/v1beta/registry/{name}/servers/{serverName}
Get a server from a registry
2 params → 200404
POST
/api/v1beta/registry/auth/login
Registry login
→ 200400500
POST
/api/v1beta/registry/auth/logout
Registry logout
→ 200400500

Schemas 43

The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are registry.ImageMetadata (21 properties), registry.RemoteServerMetadata (18 properties), model.Argument (13 properties), v0.ServerJSON (11 properties). Each schema is shown below with its type and property counts.

registry.RemoteServerMetadata
object
Remote server details (if it's a remote server)
18 properties
registry.Group
object
4 properties
permissions.Profile
object
Permission profile to apply
5 properties
model.Transport
object
Transport is required and specifies the transport protocol configuration
4 properties
model.Package
object
10 properties
pkg_api_v1.RegistryType
string
Type of registry (file, url, or default)
registry.EnvVar
object
5 properties
registry.Metadata
object
Metadata contains additional information about the server such as popularity metrics
3 properties
registry.Header
object
6 properties
model.ArgumentType
string
v0.ServerListResponse
object
2 properties
registry.KubernetesMetadata
object
Kubernetes contains Kubernetes-specific metadata when the MCP server is deployed in a cluster. This field is optional and only populated when: - The server is…
6 properties
registry.ImageMetadata
object
Container server details (if it's a container server)
21 properties
model.Repository
object
4 properties
permissions.InboundNetworkPermissions
object
Inbound defines inbound network permissions
1 property
github_com_stacklok_toolhive-core_registry_types.Registry
object
Full registry data
5 properties
registry.OAuthConfig
object
OAuthConfig provides OAuth/OIDC configuration for authentication to the remote server Used with the thv proxy command's --remote-auth flags
9 properties
v0.ServerJSON
object
11 properties
model.Format
string
v0.ResponseMeta
object
1 property
model.Icon
object
4 properties
pkg_api_v1.UpdateRegistryAuthRequest
object
OAuth authentication configuration (optional)
4 properties
v0.Metadata
object
2 properties
model.KeyValueInput
object
10 properties
pkg_api_v1.registryInfo
object
Basic information about a registry
9 properties
v0.RegistryExtensions
object
6 properties
pkg_api_v1.UpdateRegistryResponse
object
Response containing update result
1 property
registry.VerifiedAttestation
object
2 properties
pkg_api_v1.listServersResponse
object
Response containing a list of servers
2 properties
pkg_api_v1.getServerResponse
object
Response containing server details
3 properties
pkg_api_v1.getRegistryResponse
object
Response containing registry details
10 properties
permissions.OutboundNetworkPermissions
object
Outbound defines outbound network permissions
3 properties
permissions.NetworkPermissions
object
Network defines network permissions
3 properties
model.Argument
object
13 properties
pkg_api_v1.registryErrorResponse
object
Structured error response returned by registry endpoints
2 properties
registry.Provenance
object
Provenance contains verification and signing metadata
7 properties
v0.ServerResponse
object
2 properties
v0.ServerMeta
object
1 property
pkg_api_v1.UpdateRegistryRequest
object
Request containing registry configuration updates
5 properties
model.Input
object
8 properties
pkg_api_v1.registryListResponse
object
Response containing a list of registries
1 property
model.Status
string
github_com_stacklok_toolhive_pkg_registry.OAuthPublicConfig
object
AuthConfig contains the non-secret OAuth configuration when auth is configured. Nil when authstatus is "none".
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stacklok-registry-api-openapi.yml Raw ↑

Other APIs Stacklok publishes across the network.

Stacklok clients API
AE Profile APIs.io
Stacklok discovery API
AE Profile APIs.io
Stacklok groups API
AE Profile APIs.io
Stacklok logs API
AE Profile APIs.io
Stacklok registry-servers API
AE Profile APIs.io
Stacklok registry-skills API
AE Profile APIs.io
Stacklok secrets API
AE Profile APIs.io
Stacklok skills API
AE Profile APIs.io
Stacklok system API
AE Profile APIs.io
Stacklok v1 API
AE Profile APIs.io
Stacklok version API
AE Profile APIs.io
Stacklok workloads API
AE Profile APIs.io
#Registry
← Back to S APIs
API Details
ID
stacklok:stacklok-registry-api
Provider
Stacklok
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=stacklok-registry-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/stacklok-registry-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Stacklok registry API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.