Illegal Agents Playground v1 is OUT 🎉 Create an Agent now →
Logo/Docs
MCPs

API Reference for MCP Registry

Use the official Illegal Agents MCP Registry API to give your program unlimited access to all kinds of MCPs from around the internet.

Quick Start Example

Here's how to list MCPs using the API:

  curl https://illegalagents.ai/api/mcps \\
    -H "Authorization: YOUR_API_TOKEN"

For more API endpoints, visit our Explore page.

API Basics

The API is available at the base URL:

https://illegalagents.ai/api

Authentication

Keep your API token secure - treat it like a password!

To authenticate with the API:

Get Your API Token
  1. Navigate to the Illegal Agents dashboard
  1. Click your profile picture in the top-right
  1. Select "Copy API Token"
Using the Token

Include it in all API requests as shown below

  Authorization: Bearer <YOUR_API_TOKEN>

Current Features

The API currently supports:

  • MCP metadata retrieval
  • Basic query operations

Coming Soon

Custom API tokens

🔐

Coming Soon

Permission system & webhooks

Versioning

API changes will be documented in our changelog. We recommend:

  • Checking the changelog regularly
  • Testing API updates in development before production

Getting Help

For API support:

Pro Tip: The API is constantly improving. Check back often for new features!

Advanced

Want to go full ape mode? A bit goonsy woonsie? Tad bit of yolo-ing? Download our OpenAPI JSON to build on top of IllegalAgents. Or feed it to an AI. We honestly don't give a f*ck.

Explore

Explore our API Endpoints below, or from the sidebar.

How is this guide?

On this page

Facing an issue? Join our Discord, or reach out to us on email.