Toolkits

Built-in Toolkits

Agent Dojo provides ready-to-use toolkits for popular services so you can get started quickly.

Available Toolkits

The following toolkits are available out of the box. Each one comes pre-configured with tools that your AI agents can call immediately after setup.

Pushover Notifications

Available

Send push notifications to your devices using the Pushover service. Supports standard and priority alerts with customizable sounds and priorities.

send-notificationSend a standard push notification
send-priority-alertSend a high-priority alert that requires acknowledgment

Weather

Available

Retrieve current weather data for any location. Provides temperature, conditions, humidity, wind speed, and more.

get-current-weatherGet current weather data for a location

More Coming Soon

In Progress

We are actively building more built-in toolkits for popular services including email, calendar, file storage, and more. In the meantime, you can create custom toolkits for any service you need.

Browse Toolkits

You can list all available toolkits via the API:

curl https://api.agentdojo.dev/mcp/toolkits \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response:

{
  "toolkits": [
    {
      "id": "tk_abc123",
      "name": "pushover-notifications",
      "display_name": "Pushover Notifications",
      "description": "Send push notifications via Pushover",
      "toolkit_type": "hosted",
      "requires_auth": true,
      "status": "active",
      "tags": ["notifications", "push"]
    },
    {
      "id": "tk_def456",
      "name": "weather",
      "display_name": "Weather",
      "description": "Get current weather data for any location",
      "toolkit_type": "hosted",
      "requires_auth": true,
      "status": "active",
      "tags": ["weather", "data"]
    }
  ]
}

Adding a Toolkit to a Server

When creating or updating a server, include the toolkit in the toolkits array. You can optionally provide a credential_id if the toolkit requires authentication.

curl -X POST https://api.agentdojo.dev/mcp/servers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent-server",
    "display_name": "My Agent Server",
    "toolkits": [
      {
        "toolkit_id": "tk_abc123",
        "credential_id": "cred_xyz789"
      }
    ]
  }'

Credential Requirements

Most built-in toolkits require credentials to authenticate with the underlying third-party service. You should create credentials first, then reference them when adding the toolkit to your server.

  1. Create a credential via POST /mcp/credentials with your third-party API keys or tokens
  2. Note the returned credential_id
  3. Reference that credential_id when adding the toolkit to your server

Important: Without valid credentials, tools in the toolkit will return authentication errors when called by your agents. Always verify your credentials are correct before testing.

Next Steps