Clarity Fold Status Skill

Get overview and status information about Clarity Protocol's protein folding research database, including API capabilities, available endpoints, and data statistics.

Quick Start

Get full status report:

CODEBLOCK0

Get status in JSON format:

CODEBLOCK1

Status Information

The status check provides:

• - API version: Current API version
• API description: What the API provides
• Total variants: Count of protein variants in database
• Available endpoints: List of all API endpoints
• Rate limits: Anonymous and authenticated limits
• Data freshness: When data was last updated

API Endpoints

The Clarity Protocol API v1 provides these endpoints:

• - GET /api/v1/: API information
• INLINECODE1: List all variants (with filters)
• INLINECODE2: Get variant details
• INLINECODE3: Get agent findings
• INLINECODE4: List research papers
• INLINECODE5: Get paper details
• INLINECODE6: List clinical variants
• INLINECODE7: Get clinical variant details

Rate Limits

• - Anonymous (no API key): 10 requests/minute
• With API key: 100 requests/minute

To use an API key, set the CLARITY_API_KEY environment variable:

CODEBLOCK2

Get your API key at https://clarityprotocol.io

Error Handling

429 Rate Limit: You've exceeded the rate limit. The script will display how long to wait.

500 Server Error: The API server encountered an error. Try again later.

Timeout: The request took longer than 30 seconds.

Use Cases

• - Check if the API is available
• Get an overview of available data
• Verify endpoint URLs before making requests
• Monitor rate limit status
• Understand API capabilities for integration planning