GET /api/mcp/presets Bearer

List MCP Presets

Get all available MCP server presets with their installation status. Presets are pre-configured server templates that can be installed with a single click from the dashboard.

Overview

Returns all available MCP server presets (pre-configured server templates). Each preset includes metadata, required environment variables, and whether it’s already installed.

Response

Returns an array of preset objects:

id string
Unique preset identifier (e.g., filesystem, github)
name string
Human-readable display name
description string
Description of what the server provides
icon string
Lucide icon name for the preset
category string
Category grouping (e.g., filesystem, developer, data)
installed boolean
Whether this preset is already configured
env_keys array
List of environment variable names the preset requires
Terminal window
curl -X GET "http://localhost:8000/api/mcp/presets" \
  -H "Authorization: Bearer <token>"
const response = await fetch("http://localhost:8000/api/mcp/presets", {
  headers: { "Authorization": "Bearer <token>" }
});
const data = await response.json();
console.log(data);
import requests


response = requests.get(
    "http://localhost:8000/api/mcp/presets",
    headers={"Authorization": "Bearer <token>"}
)
print(response.json())
[
  {
    "id": "filesystem",
    "name": "Filesystem",
    "description": "Read, write, and manage files on the local filesystem",
    "icon": "lucide:folder",
    "category": "filesystem",
    "installed": true,
    "env_keys": []
  },
  {
    "id": "github",
    "name": "GitHub",
    "description": "Interact with GitHub repositories, issues, and pull requests",
    "icon": "lucide:github",
    "category": "developer",
    "installed": false,
    "env_keys": ["GITHUB_TOKEN"]
  }
]
Request
curl -X GET "http://localhost:8000/api/mcp/presets" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>"
const response = await fetch("http://localhost:8000/api/mcp/presets", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
},
});

const data = await response.json();
console.log(data);
import requests

response = requests.get(
    "http://localhost:8000/api/mcp/presets",
    headers={'Content-Type':'application/json','Authorization':'Bearer <token>'},
)

print(response.json())
package main

import (
    "fmt"
    "net/http"
    "io"
)

func main() {
    req, _ := http.NewRequest("GET", "http://localhost:8000/api/mcp/presets", nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer <token>")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
Response
Send a request to see the response