Catalog

Read the organization's spend budget

The ceiling on what this organization may spend on MCPJam-billed work — chat, evals, judges and computer time — in the current billing window, and how much of it has been spent.

Any member may read it: a member who cannot raise the ceiling still needs to know it exists, because it is what refused their run. capUsd: null means the organization is uncapped, which is the default.

Runs that use your own provider keys are never counted against the budget and never blocked by it. Neither is the free daily allowance — it is not credits.

GET

organizations

{organizationId}

spend-budget

Read the organization's spend budget

curl --request GET \
  --url https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "capUsd": 123,
  "capCredits": 123,
  "alertPercents": [
    123
  ],
  "spentUsd": 123,
  "spentCredits": 123,
  "windowStartAt": 123,
  "windowEndsAt": 123,
  "alertedPercents": [
    123
  ],
  "capReachedAt": 123,
  "updatedAt": 123,
  "minCapUsd": 123,
  "maxCapUsd": 123,
  "supported": true
}

Authorizations

Authorization

string

header

required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

organizationId

string

required

ID of the organization, from GET /organizations.

Response

The organization's spend budget.

An organization's ceiling on MCPJam-billed spend for the current billing window. Amounts appear in both USD and credits (1 credit = 1 cent); the credit figures are what the ledger actually stores.

capUsd

number | null

required

The ceiling in USD. null means uncapped.

capCredits

integer | null

required

The same ceiling as the ledger stores it.

alertPercents

integer[]

required

Whole percents of the cap that notify owners and admins. Reaching the cap always notifies, whether or not 100 is listed.

spentUsd

number

required

MCPJam-billed spend so far in this window, in USD.

spentCredits

integer

required

The same spend as the ledger counted it.

windowStartAt

integer

required

Start of the current billing window (epoch ms). Team and enterprise organizations run on their own subscription cycle; everyone else on the UTC month.

windowEndsAt

integer

required

When the window resets and the counter returns to zero (epoch ms).

alertedPercents

integer[]

required

Thresholds already announced this window. Each fires once per window.

capReachedAt

integer | null

required

When the cap was reached this window, or null.

updatedAt

integer | null

required

When the budget was last changed (epoch ms).

minCapUsd

number

required

The smallest budget the platform accepts.

maxCapUsd

number

required

The largest budget the platform accepts.

supported

boolean

required

False for a personal organization, which cannot have a budget.

⌘I

Read the organization's spend budget

curl --request GET \
  --url https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.mcpjam.com/api/v1/organizations/{organizationId}/spend-budget")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "capUsd": 123,
  "capCredits": 123,
  "alertPercents": [
    123
  ],
  "spentUsd": 123,
  "spentCredits": 123,
  "windowStartAt": 123,
  "windowEndsAt": 123,
  "alertedPercents": [
    123
  ],
  "capReachedAt": 123,
  "updatedAt": 123,
  "minCapUsd": 123,
  "maxCapUsd": 123,
  "supported": true
}

API Guides

Endpoints

Read the organization's spend budget

Authorizations

Path Parameters

Response