Variable relationships from research papers with causal direction and source traceback.
| Endpoint | https://hypathesis.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.16.0 |
| Now | 4 tools · grade A (93) · pin ts_45f1ad2af51f4b0c2ecb0139ac9a4506 · protocol 2025-06-18 |
| First / last listed | 2026-10-25 00:13 UTC / 2026-10-25 00:13 UTC |
| Grade over time | 2026-10-25: A (93), 4 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_analysis_status get_variable_relationships initiate_device_auth check_device_auth
get_analysis_status |
Check the processing status of an uploaded paper.
Poll this tool after uploading a PDF until status is 'Ready' before
calling get_variable_relationships.
Args:
file_id: The file_id returned by the /upload endpoint.
authorization: Optional. API key as 'Bearer hk_...' or 'hk_...'.
session_token: Optional. The session_token returned by /upload for anonymous params: file_id*, authorization, session_token |
get_variable_relationships |
Retrieve analyzed variable relationships for a completed paper.
Only returns results when get_analysis_status reports status='Ready'.
Without an API key (anonymous): returns the relationship list with
source, target, and direction — but detailed reasoning is available
only with an API key. Sign up at https://hypathesis.com to get one.
Args:
file_id: The file_id params: file_id*, authorization, session_token |
initiate_device_auth |
Start a browser-based sign-in flow to get an API key for full access.
Call this when you need detailed analysis results (reasoning, measurements)
that require authentication. Returns a verification URL to show to the user.
After the user signs in, poll check_device_auth with the returned user_code
to get the API key.
Returns:
{
"verification_url": str,
params: none |
check_device_auth |
Check if the user has completed browser sign-in for a device auth request.
Poll this after calling initiate_device_auth. Returns status 'pending'
while waiting, or 'complete' with an api_key when the user has signed in.
Use the returned api_key as the authorization parameter in other tools.
Args:
user_code: The user_code returned by initiate_device_auth.
Returns params: user_code* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.