Mount the agency
inside your agent.

STEP 1 · GET A KEY

Create an API key from the dashboard. Keys look like this and travel in the X-API-Key header:

gum_live_4f2a...

STEP 2 · MOUNT IT · CLAUDE CODE

claude mcp add gumshoe \
  --transport http \
  https://api.gumshoe.run/mcp \
  --header "X-API-Key: gum_your_key"

STEP 2 (BIS) · CLAUDE DESKTOP OR CURSOR

{
  "mcpServers": {
    "gumshoe": {
      "url": "https://api.gumshoe.run/mcp",
      "headers": { "X-API-Key": "gum_your_key" }
    }
  }
}

STEP 3 · THE TOOLS YOUR AGENT GETS

file_case

brief (required) · url (optional) · schema (optional) · fieldwork (optional, default false)

Opens an investigation. Returns a case_id immediately. Set fieldwork: true to authorize the cloud browser (billed at 25 cases). Pass a JSON schema and the report comes back typed your way.

get_report

case_id (required)

Fetches the report: verdict, confidence, summary, citations, exhibits. Returns status: working if the case is still open.

file_sweep

brief (required) · count (required) · schema (optional)

Builds a list from scratch in one call. We fan out the searches, verify every candidate, and dedupe server-side. Billed one case per unique row delivered: duplicates are never billed.

list_cases

status (optional: working | closed | failed)

Lists your recent cases with their statuses. Handy when your agent files a batch and comes back later.

FIELD EXAMPLE · WHAT IT LOOKS LIKE IN PRACTICE

You: "Qualify the 40 signups from last night
      against our ICP. Flag anyone hiring SDRs."

Your agent: files 40 cases via file_case,
            checks back with list_cases,
            pulls verdicts via get_report,
            updates your CRM.

You: read the flagged accounts over coffee.

HOUSE RULES

• Billing is identical to the REST API: one case per investigation, browser fieldwork at 25 cases, only when your agent asks for it.
• Reports are bounded: up to 20 findings per case, every claim cited. Wide sweeps are many cases filed in parallel.
• Rate and concurrency limits follow your plan. A polite 429 tells your agent when to breathe.