GET /api/mcp/status Bearer

Get MCP Status

Retrieve the status of all configured MCP servers in PocketPaw: running state, transport type (stdio/HTTP), available tools count, and last connection timestamp.

Overview

Returns the current status of all configured MCP (Model Context Protocol) servers, including their connection state, transport type, and available tools.

Response

Returns an object keyed by server name:

{server_name} object

enabled boolean

Whether the server is enabled in configuration

connected boolean

Whether the server is currently connected

transport string

Transport type: stdio or http

tools array

List of tool names available from this server

error string nullable

Error message if the server failed to connect

curl -X GET "http://localhost:8000/api/mcp/status" \
  -H "Authorization: Bearer <token>"

const response = await fetch("http://localhost:8000/api/mcp/status", {
  headers: { "Authorization": "Bearer <token>" }
});
const data = await response.json();
console.log(data);

import requests

response = requests.get(
    "http://localhost:8000/api/mcp/status",
    headers={"Authorization": "Bearer <token>"}
)
print(response.json())

{
  "filesystem": {
    "enabled": true,
    "connected": true,
    "transport": "stdio",
    "tools": ["read_file", "write_file", "list_directory"],
    "error": null
  },
  "github": {
    "enabled": false,
    "connected": false,
    "transport": "stdio",
    "tools": [],
    "error": null
  }
}

Was this page helpful?

Request

curl -X GET "http://localhost:8000/api/mcp/status" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>"

const response = await fetch("http://localhost:8000/api/mcp/status", {
  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/status",
    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/status", 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