Costs

An MCP tool from the OpenAI API server, hosted on mcp.hjlabs.in.

Costs Get costs details for the organization. [GET /organization/costs]

Name on the gateway: openai_api__usage_costs · read-only.

Parameters

Name	Type	Description
`start_time` required	`integer`	Start time (Unix seconds) of the query time range, inclusive.
`end_time`	`integer`	End time (Unix seconds) of the query time range, exclusive.
`bucket_width`	`1d`	Width of each time bucket in response. Currently only 1d is supported, default…
`project_ids`	`array`	Return only costs for these projects.
`api_key_ids`	`array`	Return only costs for these API keys.
`line_items`	`array`	Return only costs for these exact line item names. Each value must match the…
`group_by`	`array`	Group the costs by the specified fields. Supported fields include project_id…
`limit`	`integer`	A limit on the number of buckets to be returned. Limit can range between 1 and…
`page`	`string`	A cursor for use in pagination. Corresponding to the next_page field from the…

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "openai_api__usage_costs",
  "arguments": {
    "start_time": 0
  }
}

Or connect the OpenAI API server directly, which lists 371 tools including this one:

Run in your terminal

claude mcp add --transport http hj-openai-api https://mcp.hjlabs.in/mcp/openai-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the costs tool with start_time set to ….