Clarity Research Skill

Search protein folding research data from Clarity Protocol, a community-driven platform for protein mutation analysis using AlphaFold2 via ColabFold.

Quick Start

List all available variants:

CODEBLOCK0

Filter by disease:

CODEBLOCK1

Filter by protein name:

CODEBLOCK2

Output Fields

Each variant result includes:

• - id: Unique fold identifier
• INLINECODE1: Protein name (e.g., "tau", "APP")
• INLINECODE2: Mutation notation (e.g., "P301L", "A246E")
• INLINECODE3: Associated disease
• INLINECODE4: UniProt database identifier
• INLINECODE5: AlphaFold confidence score (0-100)
• INLINECODE6: When the fold was created

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:

CODEBLOCK3

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

Error Handling

404 Not Found: The endpoint or resource does not exist.

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

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

Timeout: The request took longer than 30 seconds. The server may be under heavy load.

Pagination

Results are paginated. The API returns a next_cursor field if more results are available. The script automatically handles pagination for typical queries.

Use Cases

• - Explore available protein variants for a specific disease
• Find all folded mutations for a particular protein
• Get an overview of research data available in Clarity Protocol
• Identify fold IDs for detailed analysis with other skills