Define one job
Start with one issuer, one filing family, one date or latest-filing rule, and one output artifact. For example: retrieve NVIDIA’s latest 10-K, read Item 1A, and produce a five-bullet risk brief with the filing identity.accessionNumber, form, filingDate, filingUrl, and requestId when returned. Keep route-provided provenance, freshness, warnings, and trace fields rather than replacing them with a generic confidence score.
Put the operating policy in the task
Record the endpoint or tool, arguments, retrieval time, source artifact, and request identifier with the final answer. A filing section supports claims about that section; it does not establish facts outside it.
Match the execution surface to the owner
- Use REST or an SDK when an application owns retries, timeouts, and persistence.
- Use the CLI for terminal inspection and scripts.
- Use hosted MCP when an MCP-aware client must discover tools and schemas during a research session.
tools.search, then inspect the selected input with tools.describe. For REST, use the endpoint reference rather than copying an MCP schema into a service. These surfaces have different contracts and error handling.
Keep repeated runs bounded
Before a loop, readGET /v1/billing and GET /v1/limits; use POST /v1/billing/quote for a current estimate. Quotes do not reserve usage. Billing-aware agent runs covers the account boundary and sponsored credential flow.
Next action
Write the output schema for one narrow research job, including its required filing identifiers and an explicitinsufficient_evidence outcome, before connecting it to a scheduler or chat workflow.
