> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superglue.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# Deploying a Tool
> Execute tools on-demand, schedule them, or trigger via incoming webhooks
superglue isn't just where you build tools, it's where they run. When you execute a tool, superglue handles the infrastructure: making API calls, resolving credentials server-side, managing retries and rate limiting, and logging every step. You don't need servers, queues, or cron jobs on your side.
Trigger tool runs on-demand, automate them on a schedule, or react to external events via webhooks. All through the same managed runtime.
Execute tools programmatically from your codebase using the TypeScript or Python SDK, or call
the REST API directly.
Give AI agents direct access to execute tools via Model Context Protocol in Cursor, Claude, and
other MCP clients.
Automate execution with cron schedules or trigger runs from external services like Stripe,
GitHub, or Shopify.
Execute tools directly from the tool details page:
Go to Tools in your dashboard and select the tool you want to run
Enter any required input parameters in JSON format. If your tool doesn't require input, use `{}`
Click "Run All Steps" to execute immediately. You'll see real-time logs and step-by-step progress
Check the output data and individual step results. All executions are logged for debugging.
For programmatic execution, use the REST SDK:
```bash theme={null}
npm install @superglue/client
```
**Run a saved tool:**
```typescript theme={null}
import { configure, runTool, getRun, listRuns } from "@superglue/client";
// Configure the SDK
configure({
baseUrl: "https://api.superglue.cloud", // or your self-hosted URL
apiKey: "your_api_key"
});
// Run a tool with input payload
const { data: run } = await runTool("sync-customers", {
inputs: {
startDate: "2025-01-01",
userId: "user_123"
}
});
// For synchronous runs, result is available immediately
if (run.status === "success") {
console.log(run.data); // Final output
console.log(run.stepResults); // Step-by-step details
}
```
**Run asynchronously and poll for results:**
```typescript theme={null}
// Start an async run
const { data: run } = await runTool("sync-customers", {
inputs: { startDate: "2025-01-01" },
options: { async: true }
});
// Poll for completion
let status = run.status;
while (status === "running") {
await new Promise(r => setTimeout(r, 1000));
const { data: updated } = await getRun(run.runId);
status = updated.status;
if (status === "success") {
console.log(updated.data);
}
}
```
**List recent runs:**
```typescript theme={null}
const response = await listRuns({
toolId: "sync-customers",
limit: 10
});
response.data.data.forEach(run => {
console.log(`${run.runId}: ${run.status}`);
});
```
**Pass credentials at runtime:**
```typescript theme={null}
const { data: run } = await runTool("sync-customers", {
inputs: { userId: "user_123" },
credentials: {
stripe_api_key: "sk_live_xxx",
hubspot_access_token: "pat-xxx"
}
});
```
## Enterprise deployment options
superglue Enterprise offers additional deployment capabilities for automated and event-driven execution:
Automate tool runs with cron-based scheduling. Run tools at specific times or intervals.
Trigger tools from external services like Stripe, GitHub, or Shopify via HTTP webhooks.
Chain tools together so one tool's output automatically triggers another tool.
## Tool chaining
Chain multiple tools together to build multi-step workflows. When one tool completes, it can automatically trigger another tool with its output as input.
```typescript theme={null}
// Run a tool that chains to another tool when complete
const { data: run } = await runTool("fetch-orders", {
inputs: { since: "2025-01-01" },
options: {
async: true,
webhookUrl: "tool:process-orders", // Triggers process-orders with fetch-orders output
},
});
```
The chained tool run will have `requestSource: "tool-chain"`. See the [webhooks documentation](/enterprise/webhooks#tool-chaining) for more details.