licium-sdk

Agent Resource Discovery SDK — search verified MCP servers and tools, get reputation scores, auto-report usage.

Install

npm install licium-sdk

Quick Start

import { Licium } from "licium-sdk";

const licium = new Licium();

// Search for tools by natural language
const tools = await licium.search("send email");

// Search sorted by reputation
const ranked = await licium.searchByReputation("database");

// Get details for a specific resource
const details = await licium.getResourceDetails("resource-uuid");

// Report usage (improves recommendations)
await licium.report({
  resource_id: "resource-uuid",
  success: true,
  latency_ms: 120,
});

Auto-Fallback

Execute tasks with automatic retry using alternative tools:

const result = await licium.executeWithFallback(
  "send_email",
  async (tool) => {
    // tool.name, tool.id, tool.endpointUrl, tool.specJson available
    return await callApi(tool.endpointUrl, params);
  },
  { maxRetries: 2 }
);

console.log(result.tool_used);     // which tool succeeded
console.log(result.fallback_used); // true if primary failed

Configuration

const licium = new Licium({
  apiKey: "ak_...",        // optional — enables higher rate limits
  platform: "gpt-4o",     // optional — enables model-specific recommendations
  agentId: "my-agent",    // optional — auto-generated if not set
});

API

| Method | Description | |--------|-------------| | search(query, options?) | Semantic search for tools | | searchByReputation(keyword, options?) | Keyword search sorted by reputation | | getTopRanked(limit?) | Top resources by reputation score | | getResourceDetails(id) | Detailed info for a resource | | getTrends(period?) | Demand/supply trends | | getCategories() | Category statistics | | report(usage) | Report tool usage | | use(resourceId, fn, taskType?) | Wrap usage for auto-reporting | | executeWithFallback(task, fn, options?) | Execute with automatic fallback |

License

MIT