Search the MCP registry
curl --request GET \
--url https://api.runaether.dev/orgs/{orgID}/integration-search/registry \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/orgs/{orgID}/integration-search/registry"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/orgs/{orgID}/integration-search/registry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/orgs/{orgID}/integration-search/registry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/orgs/{orgID}/integration-search/registry"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/orgs/{orgID}/integration-search/registry")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/orgs/{orgID}/integration-search/registry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"results": [
{
"install": {
"api_key": true,
"headers": {},
"kind": "remote",
"url": "<string>"
},
"kind": "server",
"server": {
"description": "<string>",
"name": "<string>",
"title": "<string>",
"version": "<string>"
}
}
],
"state": "available"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Plugins
Search the MCP registry
Searches the MCP registry for the servers whose name holds q, its first page of 20 in its order, leaving out those Aether’s directory or the organization already has.
Use this tool when you need to:
- Find an MCP server that neither Aether’s integration directory nor the official plugin marketplaces carry
- Get the fields that add a registry server to the catalog by hand: a remote server’s URL and headers, or a local server’s package
Examples:
- GET /orgs//integration-search/registry?q=postgres
Hints:
- q is required, 1 to 100 characters holding a non-space, trimmed and lowercased; the registry matches it against server names itself.
- A server is left out when a directory integration or one of the organization’s MCP servers has the URL of one of its remotes.
- Aether does not install them: each result’s install holds the add-server form’s fields as the registry gives them, kind remote (a remote server’s URL and headers) or kind package (a local server’s package at its exact version), or kind unsupported with why Aether cannot add it.
- The registry is searched for every request, through the address policy every MCP server connection takes, for at most fifteen seconds and a mebibyte; Aether keeps nothing of its answer.
- A registry that did not answer is state unavailable, with failure (unreachable, failed or invalid) and detail, and lists no servers; it is never reported as listing none.
- Use createMcpServer instead to add a server found here, and searchIntegrations to search Aether’s servers, the directory and the marketplaces.
- Owners and admins of the organization; any other role is refused with 403 org_role_insufficient, a caller outside the organization with 403 org_membership_required, and an agent host’s grant with 403 agent_host_route_not_allowed. A q the schema refuses (missing, empty, over 100 characters, or only spaces, tabs, newlines, form feeds and carriage returns) is a plain 422; one it admits that is still blank once trimmed (vertical tabs, or Unicode spaces such as U+00A0) is 422 plugin_request_invalid.
GET
/
orgs
/
{orgID}
/
integration-search
/
registry
Search the MCP registry
curl --request GET \
--url https://api.runaether.dev/orgs/{orgID}/integration-search/registry \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/orgs/{orgID}/integration-search/registry"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/orgs/{orgID}/integration-search/registry', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/orgs/{orgID}/integration-search/registry",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/orgs/{orgID}/integration-search/registry"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/orgs/{orgID}/integration-search/registry")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/orgs/{orgID}/integration-search/registry")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"results": [
{
"install": {
"api_key": true,
"headers": {},
"kind": "remote",
"url": "<string>"
},
"kind": "server",
"server": {
"description": "<string>",
"name": "<string>",
"title": "<string>",
"version": "<string>"
}
}
],
"state": "available"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}