Server-side agents / SDKs

npm install @openai/agents

SACRA_API_TOKEN=...
OPENAI_API_KEY=...

import { Agent, MCPServerStreamableHttp, run } from "@openai/agents";

export async function generateCompanyBrief(domain: string = "openai.com") {
  const { OPENAI_API_KEY, SACRA_API_TOKEN } = process.env;

  if (!OPENAI_API_KEY) {
    throw new Error("Missing OPENAI_API_KEY");
  }
  if (!SACRA_API_TOKEN) {
    throw new Error("Missing SACRA_API_TOKEN");
  }

  const mcpServer = new MCPServerStreamableHttp({
    name: "sacra_research_tools",
    url: "https://mcp.sacra.com/mcp",
    requestInit: {
      headers: {
        Authorization: `Token ${SACRA_API_TOKEN}`,
      },
    },
  });

  const agent = new Agent({
    name: "CompanyBriefAgent",
    model: "gpt-5-mini",
    instructions: `
      You are a Company Brief Agent. Your goal is to create a concise
      investor-style company brief using Sacra MCP tools.

      First, use get_company_profile with the provided company_domain.
      Then use get_funding_rounds_for_company.
      Then use get_news_for_company for recent developments.
      If the company profile includes documents and one looks useful,
      you may use get_document_content to pull extra context from one
      relevant Sacra document.

      Format your response as follows:

      # [Company Name]

      **Overview:** [2-4 sentences on what the company does and why it matters]

      **Founding and key people:**
      - [founding year and key people]

      **Funding history:**
      - [important funding rounds, investors, valuations if available]

      **Recent developments:**
      - [important recent news items from Sacra]

      **Why it matters:**
      - [short investor-style takeaway]

      Keep the output concise, factual, and grounded in the Sacra tool results.
    `,
    mcpServers: [mcpServer],
  });

  try {
    await mcpServer.connect();
    const result = await run(
      agent,
      `Create a concise investor-style company brief for ${domain}. Include the business overview, founding and key people, funding history, recent developments, and why the company matters.`,
    );
    return result.finalOutput;
  } finally {
    await mcpServer.close().catch(() => {});
  }
}