MCP Server

Protocol

The MCP endpoint speaks JSON-RPC 2.0 over HTTP at POST /api/mcp. Supported methods include initialize, notifications/initialized, tools/list, and tools/call.

Available tools

• list_probes, get_probe, update_probe, disable_probe, delete_probe, restore_probe
• list_tests, get_test, start_test, stop_test, delete_test
• list_test_results, list_raw_test_results, list_webhook_logs, list_test_targets

disable_probe is reversible - a disabled Probe keeps its history and can be brought back with restore_probe. delete_probe is permanent: it removes the Probe and all of its associated tests and results, and cannot be undone.

list_raw_test_results returns a condensed version of a test's underlying data, sized to stay reasonable for an AI assistant to work with regardless of how long the test ran. For the complete, uncondensed per-interval data, use list_test_results instead.

list_test_targets looks up the real target values (IPs or hostnames) that have actually been used in past tests, matching on a partial string you supply. Since the target filter on list_tests/start_test requires an exact match, use this tool first to find the value you want.

Security

MCP uses its own bearer token and the same action-based permissions as the REST API. Write tools validate inputs to prevent accidental data loss.

Testing

The dedicated /mcp-conf-test page lets you exercise the MCP server through any configured AI provider and inspect the full request/response chain.

curl example

List available tools with curl:

curl -s -X POST -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"tools/list"
  }' \
  https://core.linknesis.com/api/mcp | python3 -m json.tool

Call a tool:

curl -s -X POST -H "Authorization: Bearer YOUR_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"list_probes",
      "arguments":{}
    }
  }' \
  https://core.linknesis.com/api/mcp | python3 -m json.tool