cracked-ai-mastra

Mastra tools for Cracked, the tool router for AI agents: one API key, 67,000+ tools (web search, scrapers, social profiles, enrichment, media models) with measured health and a real price per call.

crackedTools() returns a { [name]: createTool() } map, one typed Mastra tool per Cracked capability, built at runtime from GET https://cracked.ai/v1/capabilities/tools?format=openai (the JSON Schema becomes the zod inputSchema). Runs go through POST /v1/run; each result carries the run permalink, status and cost.

npm install cracked-ai-mastra @mastra/core zod

import { Agent } from "@mastra/core/agent";
import { crackedTools } from "cracked-ai-mastra";

const tools = await crackedTools({ apiKey: process.env.CRACKED_API_KEY, capabilities: ["web-search", "weather-forecast"] });
const agent = new Agent({ name: "scout", instructions: "Use the tools; cite the run url.", model: "openai/gpt-4o-mini", tools });
const res = await agent.generate("What is the weather in Austin this weekend?");
console.log(res.text);
// Each tool result is { run: { runId, status, url, costUsd, durationMs }, output }.

Options: capabilities (ids, dashes or underscores), set: "top" | "all", baseUrl, maxOutputChars, timeoutMs, fetch. crackedTool("instagram-profile") returns a single tool. API errors come back as { error, status, message } so the model can read them.

Pricing

There is no subscription: each run is billed per call from your workspace balance. The price is shown on every tool page (https://cracked.ai/tools) and inside each tool description your model sees (Price: from $.../call ...). run.costUsd in every result is what that call actually cost. Full list: https://cracked.ai/capabilities and https://cracked.ai/pricing.

Keys, trial credit and referrals

• Humans: https://cracked.ai/app/keys.
• Agents can self-register without a human: POST https://cracked.ai/v1/agents/register {"name": "my-agent"} returns an apiKey (shown once, with $1 of trial credit) and a claimUrl to hand to your human; claiming adds credit and enables top-ups.
• Every workspace that signs up through your referral link (GET https://cracked.ai/v1/referrals) earns your workspace $5 of credit.
• Try a tool with no key or install: npx cracked-ai try "weather in austin".

Docs: https://cracked.ai/docs/integrations. Support: [email protected]. MIT.