Skip to content

The server gives your assistant a small JavaScript SDK in place of dozens of narrow tools. The assistant writes the exact query it needs, and the server runs that code in a sandbox.

  1. Your assistantCalls execute with a short program.
  2. SandboxRuns the program with no network, file, or environment access.
  3. odp and tsdr SDKEach call crosses to the server process.
  4. Server processAdds your key, queues the call, and caches the response.
  5. USPTOapi.uspto.gov and tsdrapi.uspto.gov

The assistant uses them in this order.

Tool What it does
search_api Searches the SDK method documentation and a dictionary of response fields. Returns signatures and ready-to-run examples.
describe_schema Looks up one entry, such as odp.patents.search, or lists a namespace, such as odp.ptab..
execute Runs JavaScript in the sandbox, with odp and tsdr as globals.

All three are read-only. Tools has their inputs and limits.

For “Has anyone challenged patent 10,169,987 at the PTAB?”, the assistant can run a program like this one:

// PTAB: every AIA trial (IPR/PGR/CBM) filed against one patent, then the
// decisions in the first trial. Calls run one at a time per API key, so keep
// the fan-out small.
const patentNumber = '10169987';
const trials = await odp.ptab.proceedings.search({
q: `patentOwnerData.patentNumber:${patentNumber}`,
fields: [
'trialNumber',
'trialMetaData.trialTypeCode',
'trialMetaData.trialStatusCategory',
'trialMetaData.petitionFilingDate',
'regularPetitionerData.realPartyInInterestName',
],
limit: 50,
});
const list = trials.patentTrialProceedingDataBag ?? [];
const first = list[0]?.trialNumber;
const decisions = first
? await odp.ptab.decisions.byTrial(first)
: { patentTrialDocumentDataBag: [] };
return {
trials: list.map((t) => ({
trial: t.trialNumber,
type: t.trialMetaData?.trialTypeCode,
status: t.trialMetaData?.trialStatusCategory,
petitioner: t.regularPetitionerData?.realPartyInInterestName,
})),
firstTrialDecisions: (decisions.patentTrialDocumentDataBag ?? []).map(
(d) => ({
date: d.decisionData?.decisionIssueDate,
type: d.decisionData?.decisionTypeCategory,
outcome: d.decisionData?.trialOutcomeCategory,
title: d.documentData?.documentTitleText,
}),
),
};

It then answers in plain English, and names the trials and decisions that it found.

  • The program has no network, file system, environment, or subprocess access.
  • The only way out is the odp and tsdr SDK. Each call goes to the server process, which adds your key and calls USPTO.
  • Each run has a time limit, 30 seconds by default, and size limits for code, results, and logs.

Security has more.

USPTO allows one request in flight for each API key, 4 to 15 requests each second, and a weekly quota. It asks clients to wait at least 5 seconds after a 429 response. So the server:

  • Sends one call at a time for each key. By default it starts at most 4 each second for ODP and 1 for TSDR.
  • Pauses a key for at least 5 seconds after a 429, then retries that call once if the pause is 30 seconds or less.
  • Caps the USPTO calls in one execute run, by default at 50 for ODP and 25 for TSDR.
  • Caches responses, for 10 minutes by default, so a repeated question does not spend quota.

Promise.all in a program is not faster: the calls still go out one at a time. A program can have at most 16 calls pending at once.