Armature · Authentication Profile

Armature Authentication

Authentication

Armature secures its APIs with oauth2 and http across 3 declared security schemes, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the authorizationCode flow(s).

CompanyAgent ExperienceMCPAnalyticsObservabilityAI AgentsProduct AnalyticsDeveloper Tools
Methods: oauth2, http Schemes: 3 OAuth flows: authorizationCode API key in: header

Security Schemes

mcpOAuth oauth2
· flows: authorizationCode
workspaceApiKey http
scheme: bearer · in: header (Authorization)
ingestApiKey apiKey
· in: header ()

Source

Authentication Profile

armature-authentication.yml Raw ↑
generated: '2026-07-18'
method: searched
source: >-
  docs.armature.tech (quickstart, sdks/*, armature-mcp/connect, security/privacy)
  and live /.well-known/oauth-authorization-server + oauth-protected-resource.
  Armature's published OpenAPI at docs.armature.tech/.armature/openapi.json was
  retired to an empty stub, so this profile is documented, not spec-derived.
summary:
  types: [oauth2, http]
  api_key_in: [header]
  oauth2_flows: [authorizationCode]
schemes:
- name: mcpOAuth
  type: oauth2
  description: >-
    OAuth 2.0 authorization-code + PKCE for the hosted MCP server
    (mcp.armature.tech/mcp). Recommended read-access method; the client is
    challenged on first contact and completes authorization in the browser.
    Dynamic client registration (RFC 7591) is supported.
  flows:
  - flow: authorizationCode
    issuer: https://app.armature.tech
    authorizationUrl: https://app.armature.tech/api/mcp/oauth/authorize
    tokenUrl: https://app.armature.tech/api/mcp/oauth/token
    registrationUrl: https://app.armature.tech/api/mcp/oauth/register
    revocationUrl: https://app.armature.tech/api/mcp/oauth/revoke
    code_challenge_methods: [S256]
    grant_types: [authorization_code, refresh_token]
    scopes:
      mcp: Read-only access to workspace agent-session analytics
  sources: [.well-known/oauth-authorization-server, docs.armature.tech/armature-mcp/connect]
- name: workspaceApiKey
  type: http
  scheme: bearer
  description: >-
    Workspace API key sent as a bearer token in the Authorization header to the
    MCP server. Created in Settings -> API keys. Governs read access; revocable
    from the dashboard.
  in: header
  parameter: Authorization
  sources: [docs.armature.tech/armature-mcp/connect]
- name: ingestApiKey
  type: apiKey
  in: header
  description: >-
    Write-only ingest key used by the TypeScript/Python/Go MCP-analytics SDKs to
    stream telemetry to Armature. Provided to the SDK via the
    ANALYTICS_INGEST_API_KEY environment variable; scoped per MCP server, minted
    once ("shown once — copy it"), rotatable/revocable per server. If the key is
    missing the SDK quietly no-ops.
  env_var: ANALYTICS_INGEST_API_KEY
  scope: write-only
  sources: [docs.armature.tech/quickstart, docs.armature.tech/sdks/python]
docs: https://docs.armature.tech/armature-mcp/connect

Work with this as data

Every security artifact here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for security posture

4 MCP tools reach this
  • find_securityBrowse and filter every security artifact in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This security artifact
curl "https://apis.io/api/v1/security/armature-authentication"
All security posture
curl "https://apis.io/api/v1/security?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

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