hypathesis

Hypathesis analyzes research papers and extracts structured variable relationships with causal direction. IMPORTANT: In Claude Desktop, use Code mode (not Chat or Cowork). Workflow: (1) upload a PDF via: curl -s -F file=@/path/to/paper.pdf https://hypathesis.com/mcp/upload — this returns a file_id and starts processing automatically, (2) poll get_analysis_status with the file_id until status is 'Ready', (3) call get_variable_relationships with the file_id to retrieve results. No account needed for basic results. With an API key you also get detailed reasoning. To get an API key, call initiate_device_auth — this gives the user a link to sign in with Google, and you get an API key automatically. IMPORTANT: After receiving an API key, save it to a file called .hypathesis-key in the working directory so it persists across sessions. On future sessions, check for .hypathesis-key first — if it exists, use that key instead of initiating device auth again. Pass the API key in the Authoriz