HeyClaude API docs

Registry

Search, trending, manifest, integrity, diff

GET/api/registry/manifestRegistry artifact manifest

Registry artifact manifest

Response

{
  "schemaVersion": 2,
  "generatedAt": "2026-05-29T00:00:00.000Z",
  "artifacts": {
    "directory-index.json": {
      "sha256": "64-char-sha256",
      "bytes": 12345
    }
  }
}

curl

curl 'https://heyclau.de/api/registry/manifest'

Live request

Read-only GET

GET/api/registry/categoriesRegistry category summaries

Registry category summaries

Response

{
  "schemaVersion": 1,
  "count": 1,
  "entries": [
    {
      "id": "mcp",
      "label": "MCP servers",
      "count": 42
    }
  ]
}

curl

curl 'https://heyclau.de/api/registry/categories'

Live request

Read-only GET

GET/api/registry/searchSearch registry entries

Search entries by query, category, and platform while preserving bounded result size.

Parameters

`q` query	string Search query.
`limit` query	number Maximum result count.

Response

{
  "schemaVersion": 1,
  "query": "mcp",
  "category": "",
  "platform": "",
  "count": 1,
  "total": 1,
  "limit": 20,
  "offset": 0,
  "nextOffset": null,
  "results": [
    {
      "category": "mcp",
      "slug": "github-mcp-server",
      "title": "GitHub MCP Server"
    }
  ],
  "facets": {
    "categories": {
      "mcp": 1
    },
    "platforms": {},
    "hasSafetyNotes": {},
    "hasPrivacyNotes": {},
    "downloadTrust": {},
    "claimStatus": {},
    "sourceStatus": {}
  }
}

curl

curl 'https://heyclau.de/api/registry/search?q=mcp&limit=5'

Live request

Read-only GET

q· query

limit· query

GET/api/registry/feedRegistry feed discovery

Discovers API, RSS, changelog, category feeds, platform feeds, category and platform shards, and artifact URLs.

Response

{
  "schemaVersion": 1,
  "kind": "registry-feed",
  "categoryFeeds": {
    "mcp": "/data/feeds/categories/mcp.json"
  },
  "platformFeeds": {
    "claude": "/data/feeds/platforms/claude.json"
  },
  "jobs": "/api/jobs?limit=100"
}

curl

curl 'https://heyclau.de/api/registry/feed'

Live request

Read-only GET

GET/api/registry/trendingPublic registry trending entries

Returns bounded privacy-safe trending registry entries from aggregate votes, community signals, intent events, and static trust metadata.

Parameters

limit

query

number

Maximum result count.

Response

{
  "schemaVersion": 1,
  "kind": "registry-trending",
  "category": "",
  "platform": "",
  "limit": 3,
  "count": 1,
  "signalsAvailable": {
    "votes": true,
    "community": true,
    "intent": true
  },
  "entries": [
    {
      "category": "mcp",
      "slug": "github-mcp-server",
      "title": "GitHub MCP Server",
      "score": 12,
      "reasons": [
        "recent usage signals"
      ],
      "platforms": [
        "claude-code"
      ],
      "tags": [
        "github"
      ],
      "dateAdded": "2026-05-01",
      "trustSignals": {
        "sourceStatus": "available"
      }
    }
  ]
}

curl

curl 'https://heyclau.de/api/registry/trending?limit=5'

Live request

Read-only GET

limit· query

GET/api/registry/diffRegistry changelog diff

Registry changelog diff

Parameters

limit

query

number

Maximum changelog event count.

Response

{
  "schemaVersion": 1,
  "count": 1,
  "entries": [
    {
      "key": "mcp/github-mcp-server",
      "type": "updated",
      "category": "mcp",
      "slug": "github-mcp-server"
    }
  ]
}

curl

curl 'https://heyclau.de/api/registry/diff?limit=10'

Live request

Read-only GET

limit· query

GET/api/registry/integrityRegistry artifact integrity verification

Lists current registry artifact hashes and verifies submitted artifact/hash pairs against the deployed manifest.

Parameters

artifact

query

string

Optional artifact path from the registry manifest.

Response

{
  "status": "snapshot",
  "artifact": null,
  "generatedAt": "2026-05-29T00:00:00.000Z"
}

curl

curl 'https://heyclau.de/api/registry/integrity?artifact=directory-index.json'

Live request

Read-only GET

artifact· query

GET/api/registry/entries/{category}/{slug}Registry entry detail

Returns entry metadata, body content, package facts, platform compatibility, and factual trustSignals when available.

Parameters

`category`* path	string
`slug`* path	string

Response

{
  "schemaVersion": 1,
  "key": "mcp:github-mcp-server",
  "entry": {
    "category": "mcp",
    "slug": "github-mcp-server",
    "title": "GitHub MCP Server"
  }
}

curl

curl 'https://heyclau.de/api/registry/entries/tools/aider'

Live request

Read-only GET

category· pathrequired

slug· pathrequired

GET/api/registry/entries/{category}/{slug}/llmsRegistry entry LLM text export

Registry entry LLM text export

Parameters

`category`* path	string
`slug`* path	string

Response

"# GitHub MCP Server\n\nMachine-readable entry text."

curl

curl 'https://heyclau.de/api/registry/entries/tools/aider/llms'

Live request

Read-only GET

category· pathrequired

slug· pathrequired

Dynamic

Votes, signals, intent events, GitHub stats

POST/api/votes/queryQuery vote counts and client state

Query vote counts and client state

Request body

{
  "keys": [
    "mcp:github-mcp-server"
  ],
  "clientId": "anon-client-1234"
}

Response

{
  "ok": true,
  "votes": {
    "mcp:github-mcp-server": true
  },
  "counts": {
    "mcp:github-mcp-server": 12
  }
}

curl

curl -X POST 'https://heyclau.de/api/votes/query' \
  -H 'content-type: application/json' \
  -d '{  "keys": [    "mcp:github-mcp-server"  ],  "clientId": "anon-client-1234"}'

Example

Sample response only

Body

POST/api/votes/toggleToggle a vote

Toggle a vote

Request body

{
  "key": "mcp:github-mcp-server",
  "clientId": "anon-client-1234",
  "vote": true
}

Response

{
  "ok": true,
  "key": "mcp:github-mcp-server",
  "voted": true,
  "count": 12
}

curl

curl -X POST 'https://heyclau.de/api/votes/toggle' \
  -H 'content-type: application/json' \
  -d '{  "key": "mcp:github-mcp-server",  "clientId": "anon-client-1234",  "vote": true}'

Example

Sample response only

Body

POST/api/intent-eventsStore a low-risk intent event

Store a low-risk intent event

Request body

{
  "targetKey": "mcp:github-mcp-server",
  "eventName": "install_copy",
  "source": "entry-detail"
}

Response

{
  "ok": true,
  "accepted": true
}

curl

curl -X POST 'https://heyclau.de/api/intent-events' \
  -H 'content-type: application/json' \
  -d '{  "targetKey": "mcp:github-mcp-server",  "eventName": "install_copy",  "source": "entry-detail"}'

Example

Sample response only

Body

GET/api/community-signalsRead community signal counts

Read community signal counts

Parameters

target

query

string

Entry key or tool target.

Response

{
  "ok": true,
  "target": "mcp:github-mcp-server",
  "signals": {}
}

curl

curl 'https://heyclau.de/api/community-signals?target=tools:aider'

Live request

Read-only GET

target· query

POST/api/community-signalsStore community signal state

Store community signal state

Request body

{
  "targetKey": "mcp:github-mcp-server",
  "signal": "used",
  "clientId": "anon-client-1234"
}

Response

{
  "ok": true,
  "accepted": true
}

curl

curl -X POST 'https://heyclau.de/api/community-signals' \
  -H 'content-type: application/json' \
  -d '{  "targetKey": "mcp:github-mcp-server",  "signal": "used",  "clientId": "anon-client-1234"}'

Example

Sample response only

Body

POST/api/community-signals/queryRead community signal counts for multiple targets

Returns aggregate used/works/broken counts for up to 100 entry or tool targets without exposing client identifiers.

Request body

{
  "targetKeys": [
    "mcp:github-mcp-server"
  ]
}

Response

{
  "ok": true,
  "signals": {}
}

curl

curl -X POST 'https://heyclau.de/api/community-signals/query' \
  -H 'content-type: application/json' \
  -d '{  "targetKeys": [    "mcp:github-mcp-server"  ]}'

Example

Sample response only

Body

GET/api/github-statsRead cached GitHub repository stats

Read cached GitHub repository stats

Response

{
  "ok": true,
  "repo": "jsonbored/awesome-claude",
  "stars": 123
}

curl

curl 'https://heyclau.de/api/github-stats'

Live request

Read-only GET

GET/api/public/alertsRead public registry alert events

Returns the current in-edge-cache registry event list used by browser-local watch alerts. Cold cache or missing webhook configuration returns an empty events array rather than simulated activity.

Response

{
  "ok": true,
  "events": []
}

curl

curl 'https://heyclau.de/api/public/alerts'

Live request

Read-only GET

Submissions

Read-only submission preflight for PR-first intake

POST/api/submissions/preflightPreflight a content submission draft

Runs read-only schema, duplicate, source, package, and safety/privacy checks before a contributor opens a single-entry content PR through the private submission gate. This endpoint never creates issues, labels, branches, pull requests, registry content, or package artifacts.

Request body

{
  "fields": {
    "name": "Example MCP Server",
    "slug": "example-mcp-server",
    "category": "mcp",
    "github_url": "https://github.com/example/example-mcp",
    "description": "A source-backed MCP server for a specific workflow."
  }
}

Response

{
  "ok": true,
  "valid": true,
  "routeSuggestion": "submit_pr",
  "prPreview": {
    "title": "Add MCP Server: Example MCP Server",
    "targetPath": "content/mcp/example-mcp-server.mdx",
    "branchHint": "heyclaude/submit-mcp-example-mcp-server",
    "baseRef": "submission-gate-pilot",
    "body": "### Name\n\nExample MCP Server"
  },
  "blockers": [],
  "warnings": []
}

curl

curl -X POST 'https://heyclau.de/api/submissions/preflight' \
  -H 'content-type: application/json' \
  -d '{  "fields": {    "name": "Example MCP Server",    "slug": "example-mcp-server",    "category": "mcp",    "github_url": "https://github.com/example/example-mcp",    "description": "A source-backed MCP server for a specific workflow."  }}'

Example

Sample response only

Body

Commercial

Lead intake for jobs, tools, claims, and sponsorship

POST/api/listing-leadsCreate a commercial listing lead

Create a commercial listing lead

Request body

{
  "kind": "claim",
  "tierInterest": "free",
  "contactName": "Maintainer",
  "contactEmail": "maintainer@example.com",
  "companyName": "Example",
  "listingTitle": "Example MCP Server",
  "websiteUrl": "https://example.com",
  "message": "Claim proof and context."
}

Response

{
  "ok": true,
  "id": "lead_123",
  "status": "new"
}

curl

curl -X POST 'https://heyclau.de/api/listing-leads' \
  -H 'content-type: application/json' \
  -d '{  "kind": "claim",  "tierInterest": "free",  "contactName": "Maintainer",  "contactEmail": "maintainer@example.com",  "companyName": "Example",  "listingTitle": "Example MCP Server",  "websiteUrl": "https://example.com",  "message": "Claim proof and context."}'

Example

Sample response only

Body

Jobs

Public reviewed jobs board API

GET/api/jobsList active reviewed jobs

Returns active D1-backed job listings for public distribution surfaces such as the jobs board and Raycast. Only reviewed active jobs are returned; private lead, review, payment, and contact fields are excluded.

Parameters

limit

query

number

Maximum job count.

Response

{
  "schemaVersion": 1,
  "kind": "jobs-index",
  "generatedAt": "2026-05-29T00:00:00.000Z",
  "count": 1,
  "total": 1,
  "totalAvailable": 1,
  "limit": 10,
  "offset": 0,
  "nextOffset": null,
  "entries": [
    {
      "slug": "example-ai-platform-engineer",
      "title": "AI Platform Engineer",
      "company": "Example Co",
      "location": "Remote",
      "description": "Build source-backed AI workflow infrastructure.",
      "featured": false,
      "applyUrl": "https://example.com/jobs/ai-platform-engineer",
      "webUrl": "https://heyclau.de/jobs/example-ai-platform-engineer",
      "labels": [
        "Remote"
      ],
      "sourceLabel": "Employer careers page",
      "applySourceLabel": "External apply via employer site"
    }
  ]
}

curl

curl 'https://heyclau.de/api/jobs?limit=10'

Live request

Read-only GET

limit· query

GET/api/jobs/{slug}Get one active reviewed job

Returns one active D1-backed public job listing plus a small related set. Expired, closed, stale, unreviewed, or source-unhealthy jobs return 404.

Parameters

slug*

path

string

Response

{
  "schemaVersion": 1,
  "kind": "jobs-detail",
  "slug": "example-ai-platform-engineer",
  "generatedAt": "2026-05-29T00:00:00.000Z",
  "entry": {
    "slug": "example-ai-platform-engineer",
    "title": "AI Platform Engineer",
    "company": "Example Co",
    "location": "Remote",
    "description": "Build source-backed AI workflow infrastructure.",
    "featured": false,
    "applyUrl": "https://example.com/jobs/ai-platform-engineer",
    "webUrl": "https://heyclau.de/jobs/example-ai-platform-engineer",
    "labels": [
      "Remote"
    ],
    "sourceLabel": "Employer careers page",
    "applySourceLabel": "External apply via employer site"
  },
  "related": []
}

curl

curl 'https://heyclau.de/api/jobs/aider'

Live request

Read-only GET

slug· pathrequired

MCP

Streamable HTTP MCP transport

POST/api/mcpRead-only HeyClaude MCP endpoint

Exposes no-key read-only HeyClaude MCP tools, resources, and prompts over Streamable HTTP for registry search, discovery, entry detail, copyable assets, comparison, compatibility lookup, install guidance, platform adapters, feed discovery, client setup, and submission draft helpers. This endpoint does not publish registry content, create submissions, open PRs, or host package artifacts.

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "search_registry"
      }
    ]
  }
}

curl

curl -X POST 'https://heyclau.de/api/mcp' \
  -H 'content-type: application/json' \
  -d ''

Example

Sample response only

Distribution

Generated registry package downloads

GET/api/brand-assets/{kind}/{domain}Resolve a cached brand icon or logo

Returns a cacheable HeyClaude-hosted brand asset backed by Brandfetch when a registry entry has a validated brand domain.

Parameters

`kind`* path	string
`domain`* path	string

Response

"Binary image response."

curl

curl 'https://heyclau.de/api/brand-assets/icon/anthropic.com'

Example

Sample response only

kind· pathrequired

domain· pathrequired

GET/api/downloadDownload generated registry packages

Serves maintainer-built package artifacts from constrained /downloads paths. Community-submitted archives are not exposed through this endpoint unless maintainers rebuild and verify the artifact.

Parameters

`category` query	string Entry category.
`slug` query	string Entry slug.

Response

"Binary package response."

curl

curl 'https://heyclau.de/api/download?category=skills&slug=agent-evals-regression-gate'

Example

Sample response only

category· query

slug· query

GET/api/public/feeds/healthRead public feed health metadata

Returns deterministic feed item counts, freshness, and ETag metadata for every public distribution feed.

Response

{
  "ok": true,
  "feeds": []
}

curl

curl 'https://heyclau.de/api/public/feeds/health'

Live request

Read-only GET

GET/api/ogGenerate social preview image

Generate social preview image

Parameters

title

query

string

Preview title.

Response

"PNG image response."

curl

curl 'https://heyclau.de/api/og?title=HeyClaude'

Example

Sample response only

title· query

GET/feed.xmlRSS feed

RSS feed

Response

"RSS XML response."

curl

curl 'https://heyclau.de/feed.xml'

Live request

Read-only GET

GET/atom.xmlAtom feed

Atom feed

Response

"Atom XML response."

curl

curl 'https://heyclau.de/atom.xml'

Live request

Read-only GET

GET/data/feeds/index.jsonStatic feed index

Static feed index

Response

{
  "schemaVersion": 1,
  "feeds": []
}

curl

curl 'https://heyclau.de/data/feeds/index.json'

Live request

Read-only GET

GET/data/feeds/categories/{category}.jsonStatic category feed

Static category feed

Parameters

category*

path

string

Response

{
  "schemaVersion": 1,
  "category": "skills",
  "entries": []
}

curl

curl 'https://heyclau.de/data/feeds/categories/skills.json'

Live request

Read-only GET

category· pathrequired

GET/data/feeds/platforms/{platform}.jsonStatic platform feed

Static platform feed

Parameters

platform*

path

string

Response

{
  "schemaVersion": 1,
  "platform": "claude",
  "entries": []
}

curl

curl 'https://heyclau.de/data/feeds/platforms/claude.json'

Live request

Read-only GET

platform· pathrequired

Newsletter

Newsletter subscribe and webhook endpoints

POST/api/newsletter/subscribeSubscribe an email to the newsletter

Subscribe an email to the newsletter

Request body

{
  "email": "reader@example.com",
  "source": "api-docs"
}

Response

{
  "ok": true,
  "subscribed": true
}

curl

curl -X POST 'https://heyclau.de/api/newsletter/subscribe' \
  -H 'content-type: application/json' \
  -d '{  "email": "reader@example.com",  "source": "api-docs"}'

Example

Sample response only

Body

POST/api/newsletter/webhookReceive Resend webhook events

Receive Resend webhook events

Response

{
  "ok": true,
  "accepted": true
}

curl

curl -X POST 'https://heyclau.de/api/newsletter/webhook' \
  -H 'content-type: application/json' \
  -d ''

Example

Sample response only

Admin

Token-protected maintainer administration

GET/api/admin/listing-leadsToken-protected lead review/export endpoint

Token-protected lead review/export endpoint

Response

{
  "ok": true,
  "entries": []
}

curl

curl 'https://heyclau.de/api/admin/listing-leads'

Example

Sample response only

PATCH/api/admin/listing-leadsUpdate listing lead status transition

Update listing lead status transition

Request body

{
  "id": "lead_123",
  "status": "pending_review"
}

Response

{
  "ok": true,
  "status": "pending_review"
}

curl

curl -X PATCH 'https://heyclau.de/api/admin/listing-leads' \
  -H 'content-type: application/json' \
  -d '{  "id": "lead_123",  "status": "pending_review"}'

Example

Sample response only

Body

GET/api/admin/jobsToken-protected reviewed jobs list

Lists D1-backed job records for maintainer review. Public jobs are rendered from active rows only; this admin endpoint can inspect all statuses.

Response

{
  "ok": true,
  "entries": []
}

curl

curl 'https://heyclau.de/api/admin/jobs'

Example

Sample response only

POST/api/admin/jobsCreate or update a reviewed D1 job

Creates or updates a private D1 job record after maintainer review. This endpoint never writes public repository content.

Request body

{
  "slug": "example-ai-platform-engineer",
  "title": "AI Platform Engineer",
  "companyName": "Example Co",
  "locationText": "Remote",
  "applyUrl": "https://example.com/jobs/ai-platform-engineer",
  "status": "pending_review",
  "sourceKind": "employer_careers"
}

Response

{
  "ok": true,
  "slug": "example-ai-platform-engineer"
}

curl

curl -X POST 'https://heyclau.de/api/admin/jobs' \
  -H 'content-type: application/json' \
  -d '{  "slug": "example-ai-platform-engineer",  "title": "AI Platform Engineer",  "companyName": "Example Co",  "locationText": "Remote",  "applyUrl": "https://example.com/jobs/ai-platform-engineer",  "status": "pending_review",  "sourceKind": "employer_careers"}'

Example

Sample response only

Body

PATCH/api/admin/jobsTransition reviewed D1 job state

Transitions reviewed job rows through active, stale, closed, archived, and revalidated states without publishing repo content.

Request body

{
  "id": "job_123",
  "status": "stale_pending_review"
}

Response

{
  "ok": true,
  "slug": "example-ai-platform-engineer",
  "status": "stale_pending_review"
}

curl

curl -X PATCH 'https://heyclau.de/api/admin/jobs' \
  -H 'content-type: application/json' \
  -d '{  "id": "job_123",  "status": "stale_pending_review"}'

Example

Sample response only

Body

GET/api/admin/jobs/healthToken-protected D1 jobs health check

Checks the jobs D1 schema, required columns, and status counts before release or operational review.

Response

{
  "ok": true,
  "requiredColumnsPresent": true,
  "statusCounts": []
}

curl

curl 'https://heyclau.de/api/admin/jobs/health'

Example

Sample response only