Account & API Keys

Account management and API key creation happen in the ToolYour dashboard, not through integration endpoints documented here.

1. Create an account

Sign up at toolyour.com/signup. Verify your email when prompted — API keys are only available after verification.

2. Choose a plan

Open Dashboard → Billing to view plans and subscribe:

Your plan sets the monthly quota for all API keys on your account. REST and MCP billable usage draws from the same pool.

3. Create an API key

Go to Dashboard → API Keys:

1. Label the key by agent (e.g. cursor-seo, ci-ship-gate)
2. Optionally set an allowed tools list (operationIds). Empty = all API-backed tools
3. Click Create key
4. Copy the full secret immediately — it is shown once

You can have up to 5 active keys per account. Rotate or revoke keys from the same page. Revoking one agent key does not affect others.

MCP async job webhook (optional)

On the same dashboard page you may configure an HTTPS webhook URL. This is not required.

• Always works without a webhook: async: true → poll get_run(runId) (or GET /mcp/runs/:id)
• If configured: ToolYour POSTs mcp.job.finished with HMAC X-ToolYour-Signature
• If missing, invalid, or delivery fails: jobs still complete; webhook errors are ignored and never break MCP

Runs are short-lived in-process (same instance that accepted the job).

Quota is shared across keys

Every successful tool call — REST or MCP invoke/workflow step (any key) — counts toward your account’s monthly limit:

• Usage resets each calendar month
• All keys share the same allowance — creating more keys does not increase quota
• The dashboard shows total usage; each key also displays its own call count for the period

When you hit the limit, tool requests return 429 until the next billing month or you upgrade.

What this documentation covers

This site documents tool endpoints only (X-Api-Key). For login, billing, and key management, use the dashboard.