POST
/
v1
/
teams
/
{teamId}
/
agent-mcp-servers
/
{serverId}
/
test
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.agentMcpServers.testAgentMcpServer({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  serverId: process.env.OCTOSPARK_SERVER_ID ?? "serverId",
})
{
  "connected": true,
  "tools": [
    "<string>"
  ],
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

​
serverId
string
required

Remote MCP server id (UUID), as returned by the list/create agent MCP servers endpoints.

Response

AgentMcpServerTestResponse

​
connected
boolean
required

Whether the server accepted the connection and listed its tools.

​
tools
string[]
required

The tool names the server listed.

​
error
string | null
required

Why the test failed, when it did.