Puma

Puma is a simple, fast, multi-threaded, and highly parallel HTTP 1.1 server for Ruby/Rack applications. It is the most popular Ruby web server and the default server for Ruby on Rails, supporting SSL, zero-downtime rolling restarts, and a built-in request bufferer. Puma is an open-source application server and not a hosted service, so it does not expose a public REST API; integration is through configuration, Rack middleware, and the Puma control application server.

Puma publishes 10 APIs on the APIs.io network, including Gc API, Gc Stats API, Halt API, and 7 more. Tagged areas include Web Server, Ruby, Rack, Application Server, and HTTP.

Puma’s developer surface includes authentication, documentation, and 10 more developer resources.

🌐 Visit website 📡 Source on GitHub

26.7/100 emerging ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1

AccessSelf serve

11 APIs

Web ServerRubyRackApplication ServerHTTPOpen Source

Kin Score

Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1

Composite quality — 26.7/100 · emerging

Contract Quality 14.7 / 25

Developer Ergonomics 3.9 / 20

Commercial Clarity 0.0 / 20

Operational Transparency 0.7 / 13

Governance 0.0 / 12

Discoverability 7.4 / 10

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/puma: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

GitHubRepository

GitHubRepository

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 2

Status, limits, changes, and where to get help

Issues

Issues

Forums

Forums

Commercial 1

Pricing, plans, and the legal terms of use

License

License

Company 2

The organization behind the API

LinkedIn

Website

Website

Other 1

Properties that don't map to a standard resource type

RubyGems

RubyGems

Source (apis.yml)

aid: puma
name: Puma
description: Puma is a simple, fast, multi-threaded, and highly parallel HTTP 1.1 server for Ruby/Rack applications. It is
  the most popular Ruby web server and the default server for Ruby on Rails, supporting SSL, zero-downtime rolling restarts,
  and a built-in request bufferer. Puma is an open-source application server and not a hosted service, so it does not expose
  a public REST API; integration is through configuration, Rack middleware, and the Puma control application server.
type: Index
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/puma.png
tags:
- Web Server
- Ruby
- Rack
- Application Server
- HTTP
- Open Source
url: https://raw.githubusercontent.com/api-evangelist/puma/refs/heads/main/apis.yml
created: '2026-05-11'
modified: '2026-05-11'
specificationVersion: '0.19'
apis:
- aid: puma:control-app
  name: Puma Control/Status Application
  description: Puma ships with an optional control/status HTTP application that can be bound to a local port or Unix socket
    and queried for runtime statistics (busy threads, worker status, backlog) and lifecycle control (stop, restart, halt).
    Authentication uses a shared control token passed via the `token` query parameter.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Control
  - Status
  - Operations
  - Ruby
  properties:
  - type: Documentation
    url: https://github.com/puma/puma/blob/master/docs/restart.md
  - type: Source Code
    url: https://github.com/puma/puma
- aid: puma:puma-gc-api
  name: Puma Gc API
  description: The Gc API from Puma — 1 operation(s) for gc.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Gc
  properties:
  - type: OpenAPI
    url: openapi/puma-gc-api-openapi.yml
- aid: puma:puma-gc-stats-api
  name: Puma Gc Stats API
  description: The Gc Stats API from Puma — 1 operation(s) for gc stats.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Gc Stats
  properties:
  - type: OpenAPI
    url: openapi/puma-gc-stats-api-openapi.yml
- aid: puma:puma-halt-api
  name: Puma Halt API
  description: The Halt API from Puma — 1 operation(s) for halt.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Halt
  properties:
  - type: OpenAPI
    url: openapi/puma-halt-api-openapi.yml
- aid: puma:puma-phased-restart-api
  name: Puma Phased Restart API
  description: The Phased Restart API from Puma — 1 operation(s) for phased restart.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Phased Restart
  properties:
  - type: OpenAPI
    url: openapi/puma-phased-restart-api-openapi.yml
- aid: puma:puma-refork-api
  name: Puma Refork API
  description: The Refork API from Puma — 1 operation(s) for refork.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Refork
  properties:
  - type: OpenAPI
    url: openapi/puma-refork-api-openapi.yml
- aid: puma:puma-reload-worker-directory-api
  name: Puma Reload Worker Directory API
  description: The Reload Worker Directory API from Puma — 1 operation(s) for reload worker directory.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Reload Worker Directory
  properties:
  - type: OpenAPI
    url: openapi/puma-reload-worker-directory-api-openapi.yml
- aid: puma:puma-restart-api
  name: Puma Restart API
  description: The Restart API from Puma — 1 operation(s) for restart.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Restart
  properties:
  - type: OpenAPI
    url: openapi/puma-restart-api-openapi.yml
- aid: puma:puma-stats-api
  name: Puma Stats API
  description: The Stats API from Puma — 1 operation(s) for stats.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Stats
  properties:
  - type: OpenAPI
    url: openapi/puma-stats-api-openapi.yml
- aid: puma:puma-stop-api
  name: Puma Stop API
  description: The Stop API from Puma — 1 operation(s) for stop.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Stop
  properties:
  - type: OpenAPI
    url: openapi/puma-stop-api-openapi.yml
- aid: puma:puma-thread-backtraces-api
  name: Puma Thread Backtraces API
  description: The Thread Backtraces API from Puma — 1 operation(s) for thread backtraces.
  humanURL: https://github.com/puma/puma/blob/master/docs/restart.md
  baseURL: http://127.0.0.1:9293
  tags:
  - Thread Backtraces
  properties:
  - type: OpenAPI
    url: openapi/puma-thread-backtraces-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/puma-agentic-access.yml
- type: DomainSecurity
  url: security/puma-domain-security.yml
- type: Authentication
  url: authentication/puma-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/puma
- type: Website
  url: https://puma.io
- type: Documentation
  url: https://puma.io/puma/
- type: GitHubOrganization
  url: https://github.com/puma
- type: GitHubRepository
  url: https://github.com/puma/puma
- type: RubyGems
  url: https://rubygems.org/gems/puma
- type: Issues
  url: https://github.com/puma/puma/issues
- type: Forums
  url: https://github.com/puma/puma/discussions
- type: License
  url: https://github.com/puma/puma/blob/master/LICENSE
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Puma

Kin Score

APIs 11

Puma Control/Status Application

Puma Gc API

Puma Gc Stats API

Puma Halt API

Puma Phased Restart API

Puma Refork API

Puma Reload Worker Directory API

Puma Restart API

Puma Stats API

Puma Stop API

Puma Thread Backtraces API

Open Collections 1

Puma Control/Status Application API

Security Posture 2

Puma Authentication

Puma Domain Security

Agentic Access 1

Puma Agentic Access