Model Context Protocol (MCP)

Documentation Index

Fetch the complete documentation index at: https://docs.sacra.com/llms.txt

Use this file to discover all available pages before exploring further.

1. MCP Client / MCP Host — Connect Sacra MCP inside ChatGPT or Claude using OAuth.
2. Server-side — Connect to Sacra’s MCP server from your own backend using a Sacra API key + OpenAI Agents SDK or another Agent SDK.

​

1. Using Sacra MCP in Claude & ChatGPT

​

Claude MCP

1. Open Connectors in Claude settings: Go to Settings and then Connectors and click “Add custom connector”.
2. Configure the connection: Enter the following information, click “Add”, login to Sacra and review & accept the permissions.
   • Name: Sacra Private Markets Research
   • Remote MCP Server URL: https://mcp.sacra.com/mcp
3. Sacra MCP Server URL
4. Start using the Sacra connector: Ask Claude questions about growth & pre-IPO companies, and instruct Claude with “Use the Sacra MCP”.

​

ChatGPT MCP

1. Turn on Developer Mode: Go to Advanced settings in Apps Settings and enable Developer Mode. Sacra only reads data and never modifies or deletes your data.
2. Create the Sacra app: Click “Create app” in that same Advanced settings modal (or from Apps settings) and use:
   • Icon (Optional): Feel free to upload the Sacra logo.
   • Name: Sacra
   • Description: Private company data & research on growth & pre-IPO startups
   • MCP Server URL: https://mcp.sacra.com/openai/mcp
   • Authentication: OAuth
   • OAuth Client ID: Leave blank
   • OAuth Client Secret: Leave blank
   • I understand and want to continue: ✅
3. Sign in and allow access: Continue to the Sacra sign-in screen, then click “Allow”.
4. Use Sacra in chat: Say “Use Sacra” when you want Sacra data. ChatGPT will request tool permissions; approve and continue.

​

2. Server-side MCP Integration

​

High-level flow

1. Create a Sacra API key in your Organization Settings.
2. Store it as SACRA_API_TOKEN in your server environment.
3. Connect to https://mcp.sacra.com/mcp.
4. Pass the API key in the Authorization header as Token YOUR_API_KEY.
5. Run an agent that uses Sacra MCP tools to generate a company brief.

​

Demo Prerequisites

• Sacra account with API access
• Sacra API key
• OpenAI API key
• TypeScript / Node environment

npm install @openai/agents

​

Environment Variables

SACRA_API_TOKEN=...
OPENAI_API_KEY=...

​

Migration Note for Existing M2M Users

• Remove the Stytch token exchange step.
• Stop sending Authorization: Bearer ....
• Use a Sacra API key from your Organization Settings.
• Send it as Authorization: Token YOUR_API_KEY.

​

Example: Build a Company Brief Generator

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(() => {});
  }
}

​

What This Example Does

• Connects directly to Sacra MCP at https://mcp.sacra.com/mcp
• Authenticates with Authorization: Token YOUR_API_KEY
• Uses Sacra MCP tools to gather company profile, funding, and recent news
• Returns a concise company brief that can power a user-facing feature

​

3. Security Notes

• Store SACRA_API_TOKEN in a secure secret manager or server environment.
• Never expose your API key in client-side code.
• Rotate API keys from your Sacra organization settings if needed.