Scope3

Scope3 Gpu API

The Gpu API from Scope3 — 2 operation(s) for gpu.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /gpu List GPUs · List GPUs #

Ask an LLM

“Which GPUs are available for AI impact calculations?”

“Can I see both global and custom GPU definitions?”

Tell an agent

List all GPUs.

Show the GPU catalog used for impact estimates.

POST /gpu Register a custom GPU · Create a GPU #

Ask an LLM

“How do I add a GPU that isn't in the catalog?”

“What power and embodied emissions figures does a new GPU need?”

Tell an agent

Create GPU {id} named {name} at {max_power_w} W, {embodied_emissions_kgco2e} kgCO2e and {embodied_water_mlh2o} mL water embodied.

Set GPU {id} performance vs H200 to {performance_ratio_to_h200}, OLS coefficient {ols_coefficient_gpu_count}, intercept {ols_intercept}.

GET /gpu/{gpuId} Get a GPU's specs · Get a specific GPU (global or custom) #

Ask an LLM

“What max power and embodied emissions are recorded for a GPU?”

“Can I look up one GPU by ID?”

Tell an agent

Get GPU {gpuId}.

Show the power draw of GPU {gpuId}.

PUT /gpu/{gpuId} Update a GPU · Update a GPU #

Ask an LLM

“Can I correct a GPU's max power figure?”

“How do I change a GPU's performance ratio to the H200?”

Tell an agent

Set max power of GPU {gpuId} to {max_power_w} W.

Update GPU {gpuId} performance ratio to {performance_ratio_to_h200}.

DELETE /gpu/{gpuId} Delete a GPU · Delete a GPU #

Ask an LLM

“Can I remove a custom GPU I added?”

“Is deleting a GPU definition reversible?”

Tell an agent destructive · confirm first

Delete GPU {gpuId}.

Remove custom GPU {gpuId}.

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/scope3/refs/heads/main/openapi/scope3-gpu-api-openapi.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/scope3:scope3-gpu-api"

All apis

curl "https://apis.io/api/v1/apis?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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  version: 1.0.0
  title: AI impact measurement Gpu API
security:
- bearerAuth: []
tags:
- name: Gpu
paths:
  /gpu:
    get:
      servers:
      - url: https://aiapi.scope3.com
        description: API server
      security:
      - bearerAuth: []
      summary: List GPUs
      operationId: listGPUs
      responses:
        '200':
          description: GPU details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GPUResponse'
        '406':
          description: Not acceptable response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '415':
          description: Unsupported media type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Gpu
    post:
      servers:
      - url: https://aiapi.scope3.com
        description: API server
      security:
      - bearerAuth: []
      summary: Create a GPU
      operationId: createGPU
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GPUCreateRequest'
      responses:
        '201':
          description: GPU created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GPU'
        '400':
          description: Invalid request format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: GPU ID already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Gpu
  /gpu/{gpuId}:
    parameters:
    - name: gpuId
      in: path
      required: true
      schema:
        type: string
    get:
      servers:
      - url: https://aiapi.scope3.com
        description: API server
      security:
      - bearerAuth: []
      summary: Get a specific GPU (global or custom)
      operationId: getGPU
      responses:
        '200':
          description: GPU retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GPU'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: GPU not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Gpu
    put:
      servers:
      - url: https://aiapi.scope3.com
        description: API server
      security:
      - bearerAuth: []
      summary: Update a GPU
      operationId: updateGPU
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GPUUpdateRequest'
      responses:
        '200':
          description: GPU updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GPU'
        '400':
          description: Invalid request format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: GPU not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Gpu
    delete:
      servers:
      - url: https://aiapi.scope3.com
        description: API server
      security:
      - bearerAuth: []
      summary: Delete a GPU
      operationId: deleteGPU
      responses:
        '204':
          description: GPU deleted successfully
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: GPU not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Gpu
components:
  schemas:
    GPUResponse:
      title: GPU Response
      type: object
      additionalProperties: false
      required:
      - gpus
      properties:
        gpus:
          type: array
          maxItems: 100
          items:
            $ref: '#/components/schemas/GPU'
    GPUUpdateRequest:
      type: object
      properties:
        name:
          type: string
          example: NVIDIA A100 40GB
        max_power_w:
          type: number
          example: 700
          format: float
          x-go-type: float64
        embodied_emissions_kgco2e:
          type: number
          example: 282.1
          format: float
          x-go-type: float64
        embodied_water_mlh2o:
          type: number
          example: 181.1
          format: float
          x-go-type: float64
        performance_ratio_to_h200:
          type: number
          example: 1.5
          format: float
          x-go-type: float64
        ols_coefficient_gpu_count:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
        ols_intercept:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
    GPUCreateRequest:
      type: object
      required:
      - id
      - name
      - max_power_w
      - embodied_emissions_kgco2e
      - embodied_water_mlh2o
      - performance_ratio_to_h200
      - ols_intercept
      - ols_coefficient_gpu_count
      properties:
        name:
          type: string
          example: NVIDIA A100 40GB
        id:
          type: string
          example: a100_40gb
        max_power_w:
          type: number
          example: 700
          format: float
          x-go-type: float64
        embodied_emissions_kgco2e:
          type: number
          example: 282.1
          format: float
          x-go-type: float64
        embodied_water_mlh2o:
          type: number
          example: 181.1
          format: float
          x-go-type: float64
        performance_ratio_to_h200:
          type: number
          example: 1.5
          format: float
          x-go-type: float64
        ols_coefficient_gpu_count:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
        ols_intercept:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
    Error:
      type: object
      additionalProperties: false
      required:
      - message
      properties:
        code:
          type: string
        message:
          type: string
        details:
          type: object
          properties:
            reason:
              type: string
            field:
              type: string
    GPU:
      type: object
      required:
      - id
      - name
      - max_power_w
      - embodied_emissions_kgco2e
      - embodied_water_mlh2o
      - performance_ratio_to_h200
      - ols_intercept
      - ols_coefficient_gpu_count
      - created_at
      - updated_at
      - customer_id
      - created_by
      additionalProperties: false
      properties:
        name:
          type: string
          example: NVIDIA A100 40GB
        id:
          type: string
          example: a100_40gb
        max_power_w:
          type: number
          example: 700
          format: float
          x-go-type: float64
        embodied_emissions_kgco2e:
          type: number
          example: 282.1
          format: float
          x-go-type: float64
        embodied_water_mlh2o:
          type: number
          example: 181.1
          format: float
          x-go-type: float64
        performance_ratio_to_h200:
          type: number
          example: 1.5
          format: float
          x-go-type: float64
        ols_coefficient_gpu_count:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
        ols_intercept:
          type: number
          example: 11.4
          format: float
          x-go-type: float64
        customer_id:
          type: integer
          x-go-type: int64
          description: ID of the customer who owns this node (visible to admins only)
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        created_by:
          type: string
          description: ID of the user who created the node (admin or owner only)
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT