Search for tools, navigate pages, or compare tools
HTTP API
The public REST surface served at https://api.neurynae.com. Use the MCP server when you can — it handles auth, retries, and response shaping. Use these endpoints directly when you need bespoke integration or aren't calling from an agent.
ToolCairn/v1/searchSearch the catalog with a natural-language query.
Request body
{
"query": "fast http client for node",
"context": { "language": "typescript" },
"query_id": "<uuid, optional>"
}Response
{
"ok": true,
"data": {
"matches": [{ "name": "undici", "score": 0.91, /* ... */ }],
"clarification_questions": [],
"query_id": "<echoed>"
}
}If clarification_questions is non-empty, follow up with POST /v1/search/respond.
/v1/search/respondSubmit answers to clarification questions and refine search results.
Request body
{
"query_id": "<from /v1/search>",
"answers": [{ "dimension": "deployment_model", "value": "self-hosted" }]
}Response
{ "ok": true, "data": { "matches": [ /* ... */ ] } }/v1/intelligence/refineDecompose a vague use-case prompt into structured sub-needs.
Request body
{
"classification": "stack_building",
"prompt": "Build a TypeScript SaaS backend",
"project_context": { "language": "typescript" }
}Response
{ "ok": true, "data": { "decomposition_prompt": "...", "sub_needs": [ ... ] } }/v1/intelligence/get-stackRecommend a complementary tool stack for a use case.
Request body
{
"use_case": "TypeScript SaaS backend",
"sub_needs": [
{ "sub_need_type": "web-framework", "keyword_sentence": "typescript express fastify hono" }
],
"constraints": { "language": "typescript" }
}Response
{
"ok": true,
"data": {
"stack": [{ "name": "fastify", "version": "...", "compatibility": { /* ... */ } }],
"compatibility_matrix": [ ... ],
"stack_compatibility": "high"
}
}/v1/intelligence/compareCompare two tools head-to-head with health and ecosystem signals.
Request body
{ "tool_a": "express", "tool_b": "fastify", "use_case": "REST API" }Response
{ "ok": true, "data": { "tool_a": { /* ... */ }, "tool_b": { /* ... */ }, "recommendation": "tool_b" } }/v1/intelligence/check-compatibilityEvaluate whether two tools are known to work together.
Request body
{ "tool_a": "next.js", "tool_b": "react", "tool_a_version": "14", "tool_b_version": "17" }Response
{
"ok": true,
"data": {
"compatibility_signal": "incompatible",
"version_checks": [ ... ],
"source": "declared_dependency"
}
}/v1/feedback/outcomeFire-and-forget — report whether a recommended tool worked out.
Request body
{
"query_id": "<from /v1/search>",
"chosen_tool": "fastify",
"outcome": "success"
}Response
{ "ok": true, "recorded": true }/v1/healthLightweight liveness probe. Public, no auth required.
Response
{ "status": "ok", "version": "..." }Failures return a shape that's safe to surface to your users. The errId is unique per request and helps us trace the origin without exposing internal stack traces.
{
"ok": false,
"error": {
"code": "rate_limited",
"message": "Free tier daily quota exhausted.",
"errId": "01HZX..."
}
}