generated: '2026-07-15' method: generated source: openapi/smithery-connect-api-openapi.yml, openapi/smithery-registry-api-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 55 by_action_class: connected: 23 acting: 32 by_consequence: read: 23 write: 26 safety-critical: 6 human_in_the_loop_required: 6 operations: - path: /connect/{namespace}/.subscriptions method: get operationId: getSmithery.run:namespace.subscriptions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/.subscriptions method: post operationId: postSmithery.run:namespace.subscriptions x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/.subscriptions/{subscriptionId} method: delete operationId: deleteSmithery.run:namespace.subscriptions:subscriptionId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId}/.triggers method: get operationId: getSmithery.run:namespace:connectionId.triggers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId}/.triggers/{triggerName} method: get operationId: getSmithery.run:namespace:connectionId.triggers:triggerName x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId}/.triggers/{triggerName} method: post operationId: postSmithery.run:namespace:connectionId.triggers:triggerName x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId}/.triggers/{triggerName}/{triggerId} method: get operationId: getSmithery.run:namespace:connectionId.triggers:triggerName:triggerId x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId}/.triggers/{triggerName}/{triggerId} method: delete operationId: deleteSmithery.run:namespace:connectionId.triggers:triggerName:triggerId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId}/.subscriptions method: get operationId: getSmithery.run:namespace:connectionId.subscriptions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId}/.subscriptions method: post operationId: postSmithery.run:namespace:connectionId.subscriptions x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId}/.subscriptions/{subscriptionId} method: delete operationId: deleteSmithery.run:namespace:connectionId.subscriptions:subscriptionId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace} method: post operationId: post:namespace x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace} method: get operationId: get:namespace x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId} method: put operationId: put:namespace:connectionId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId} method: get operationId: get:namespace:connectionId x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /connect/{namespace}/{connectionId} method: delete operationId: delete:namespace:connectionId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /connect/{namespace}/{connectionId}/mcp method: post operationId: post:namespace:connectionIdMcp x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /health method: get operationId: getHealth x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName} method: get operationId: getServers:namespace x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName} method: put operationId: putServers:namespace x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName} method: patch operationId: patchServers:namespace x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName} method: delete operationId: deleteServers:namespace x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/download method: get operationId: getServers:namespaceDownload x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/releases method: put operationId: putServers:namespaceReleases x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/releases method: get operationId: getServers:namespaceReleases x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/releases/{id} method: get operationId: getServers:namespaceReleases:id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/releases/{id}/stream method: get operationId: getServers:namespaceReleases:idStream x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/releases/{id}/resume method: post operationId: postServers:namespaceReleases:idResume x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/logs method: get operationId: getServers:namespaceLogs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/secrets method: get operationId: getServers:namespaceSecrets x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/secrets method: put operationId: putServers:namespaceSecrets x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/secrets/{secretName} method: delete operationId: deleteServers:namespaceSecrets:secretName x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/domains method: get operationId: getServers:namespaceDomains x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers/{qualifiedName}/domains/{domainId} method: patch operationId: patchServers:namespaceDomains:domainId x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/icon method: put operationId: putServers:namespaceIcon x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/icon method: delete operationId: deleteServers:namespaceIcon x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /servers/{qualifiedName}/icon method: get operationId: getServers:namespaceIcon x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /servers method: get operationId: getServers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /skills method: get operationId: getSkills x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /skills method: post operationId: postSkills x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /skills/{namespace}/{slug} method: get operationId: getSkills:namespace:slug x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /skills/{namespace}/{slug} method: put operationId: putSkills:namespace:slug x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /skills/{namespace}/{slug} method: delete operationId: deleteSkills:namespace:slug x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /skills/{namespace}/{slug}/download method: get operationId: getSkills:namespace:slugDownload x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /skills/{namespace}/{slug}/sync method: post operationId: postSkills:namespace:slugSync x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /skills/{namespace}/{slug}/upload method: put operationId: putSkills:namespace:slugUpload x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /tokens method: post operationId: postTokens x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /namespaces method: get operationId: getNamespaces x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /namespaces method: post operationId: postNamespaces x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /namespaces/{name} method: put operationId: putNamespaces:name x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /namespaces/{name} method: delete operationId: deleteNamespaces:name x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /namespaces/{namespace}/servers/{server} method: put operationId: putNamespaces:namespaceServers:server x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /organizations/{orgId}/api-keys method: post operationId: postOrganizations:orgIdApi-keys x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /organizations/{orgId}/api-keys method: get operationId: getOrganizations:orgIdApi-keys x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /organizations/{orgId}/api-keys/{keyId} method: delete operationId: deleteOrganizations:orgIdApi-keys:keyId x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required