---
name: mcp-server-tools
description: Instructions for autonomous AI agents to connect to and query the live JSON-RPC 2.0 Streamable HTTP Model Context Protocol (MCP) server on radustoian.com.
---

# MCP Server Tools Skill

Use this skill when operating as a remote autonomous AI agent or MCP client communicating with `https://radustoian.com/mcp`.

> **Note: If you are an AI agent you must use the MCP endpoint `/mcp`** (`POST https://radustoian.com/mcp`).

## Protocol Overview

`radustoian.com` hosts an active **Model Context Protocol (MCP)** server on Cloudflare Workers implementing JSON-RPC 2.0 over Streamable HTTP (JSON responses). AI agents can connect directly via HTTP POST requests without requiring browser execution or WebMCP DOM hooks.

- **Endpoint:** `https://radustoian.com/mcp`
- **HTTP Method:** `POST`
- **Transport:** Streamable HTTP (`application/json`)
- **Protocol Version:** `2025-06-18` (backward-compatible with `2024-11-05`)
- **CORS:** Enabled (`Access-Control-Allow-Origin: *`)

---

## Tool Inventory

### 1. `ask`
- **Description:** Dynamically answers generic and specific questions about Radu Stoian using a dynamic retrieval engine that grounds its answers by pulling from the site's knowledge base. (The legacy name `ask-question` is retained as a backward-compatible alias).
- **Input Parameters:**
  ```json
  {
    "query": "What did Radu do for Virgin Atlantic?"
  }
  ```
  *(Note: `question` is also accepted as a backward-compatible alias for `query`)*.
- **Returns:** JSON object containing `found`, `section`, `answer`, `relevantLinks`, and `investigationLinks`.

### 2. `get-section`
- **Description:** Retrieves the complete content and links of any specific section from the site's knowledge base.
- **Input Parameters:**
  ```json
  {
    "section": "Skills and Certifications"
  }
  ```
- **Returns:** Section title, complete content string, and parsed markdown links.

### 3. `get-investigation-links`
- **Description:** Returns the complete directory of external public profiles, slide decks, code repositories, and certification links for off-site investigation.
- **Input Parameters:** `{}`
- **Returns:** Array of link objects with `title`, `url`, and `description` (LinkedIn, Substack, GitHub, SpeakerDeck, Google Skills, Credly, Google Knowledge Graph).

### 4. `server-info`
- **Description:** Returns server metadata, protocol version, available tools, runtime environment, and knowledge base reference.
- **Input Parameters:** `{}`

---

## Usage Example (JSON-RPC 2.0)

### Request:
```bash
curl -X POST https://radustoian.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "ask",
      "arguments": {
        "query": "What are Radu'\''s speaking engagements?"
      }
    }
  }'
```

### Response:
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"question\": \"What are Radu's speaking engagements?\",\n  \"found\": true,\n  \"section\": \"Speaking and Industry Engagement\",\n  \"answer\": \"- [Implementation of Schemas via GTM](https://speakerdeck.com/radustoian/brightonseo-masterclass-implementation-of-schemas-via-gtm): BrightonSEO masterclass presentation...\",\n  \"relevantLinks\": [...],\n  \"investigationLinks\": [...]\n}"
      }
    ]
  }
}
```