Wayfound

https://docs.wayfound.ai/
Admin
Wayfound is the world's first AI Agent Supervisor platform. Our platform helps businesses supervise,...
Tokens:15,598
Snippets:245
Trust Score:7
Update:4 months ago
Show doc for...
Tokens:
Raw
### Query Documentation Example

Source: https://docs.wayfound.ai/agents/opentelemetry-event-data.md

Example of how to perform an HTTP GET request to query the documentation dynamically by appending the 'ask' query parameter to the page URL.

```http
GET https://docs.wayfound.ai/agents/opentelemetry-event-data.md?ask=<question>
```

--------------------------------

### Install Wayfound SDK with Pip (Python)

Source: https://docs.wayfound.ai/agents/connecting-agents.md

Install the Wayfound Python SDK using pip. This is the first step to integrating your Python agents with Wayfound.

```bash
pip install wayfound
```

--------------------------------

### Install Wayfound SDK with NPM (JavaScript)

Source: https://docs.wayfound.ai/agents/connecting-agents.md

Install the Wayfound JavaScript SDK using npm. This is required for integrating your JavaScript agents with Wayfound.

```bash
npm install wayfound
```

--------------------------------

### Query Documentation with GET Request

Source: https://docs.wayfound.ai/supervisor/global-guidelines.md

Perform an HTTP GET request on the current page URL with the `ask` query parameter to dynamically query the documentation. Use this when the answer is not explicitly present, for clarification, or to retrieve related sections.

```http
GET https://docs.wayfound.ai/supervisor/global-guidelines.md?ask=<question>
```

--------------------------------

### Querying Documentation with GET Request

Source: https://docs.wayfound.ai/agents/connecting-user-feedback.md

To ask questions about the documentation, perform an HTTP GET request on the page URL with the 'ask' query parameter. The question should be specific and in natural language.

```http
GET https://docs.wayfound.ai/agents/connecting-user-feedback.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/agents/the-agents-page.md

Use this HTTP GET request to ask questions about the documentation. The response includes direct answers and relevant excerpts.

```bash
GET https://docs.wayfound.ai/agents/the-agents-page.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET Request

Source: https://docs.wayfound.ai/skills/agent-skill.md

Perform an HTTP GET request on the documentation URL with the 'ask' query parameter to dynamically query the documentation. Use this when the answer is not explicitly present, for clarification, or to retrieve related sections.

```http
GET https://docs.wayfound.ai/skills/agent-skill.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/supervisor/reports.md

To ask questions about the documentation, send an HTTP GET request to the current page URL with an 'ask' query parameter containing your question. The response will provide a direct answer along with relevant excerpts and sources.

```http
GET https://docs.wayfound.ai/supervisor/reports.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/key-concepts.md

To get information not directly on a page, make an HTTP GET request to the page URL with an 'ask' query parameter containing your question. The response includes the answer and relevant documentation excerpts.

```http
GET https://docs.wayfound.ai/key-concepts.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/agents

Perform an HTTP GET request on the current page URL with the `ask` query parameter to dynamically query the documentation. The question should be specific and in natural language. Use this when the answer is not explicitly present or for clarification.

```http
GET https://docs.wayfound.ai/agents.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/settings/organizations.md

Perform an HTTP GET request to query the documentation. Include your question in the `ask` query parameter. The response will contain a direct answer and relevant excerpts.

```http
GET https://docs.wayfound.ai/settings/organizations.md?ask=<question>
```

--------------------------------

### Query Documentation with GET Request

Source: https://docs.wayfound.ai/sessions

Perform an HTTP GET request on the current page URL with the `ask` query parameter to dynamically query the documentation. The question should be specific and in natural language. Use this when the answer is not explicitly present on the page.

```http
GET https://docs.wayfound.ai/sessions.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/sessions/recordings.md

Perform an HTTP GET request to query the documentation dynamically. Use the 'ask' query parameter with a natural language question. The response includes a direct answer and relevant excerpts.

```http
GET https://docs.wayfound.ai/sessions/recordings.md?ask=<question>
```

--------------------------------

### Query Documentation with HTTP GET

Source: https://docs.wayfound.ai/agents/connecting-to-agentforce.md

Perform an HTTP GET request to query documentation dynamically. Include a specific, self-contained question in natural language as the 'ask' query parameter. The response will contain a direct answer and relevant excerpts.

```HTTP
GET https://docs.wayfound.ai/agents/connecting-to-agentforce.md?ask=<question>
```

--------------------------------

### OpenTelemetry Event Data Example

Source: https://docs.wayfound.ai/agents/opentelemetry-event-data.md

An example JSON payload demonstrating the supported OpenTelemetry fields (context, resource, instrumentation) and their sub-fields for an event.

```json
{
  "timestamp": "2025-05-08T17:00:00.000Z",
  "context": {
    "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736",
    "span_id": "00f067aa0ba902b7",
    "parent_span_id": "3d7a2b8f9e1c4f2a"
  },
  "resource": {
    "service.name": "chat-interface-agent",
    "service.version": "3.2.1",
    "deployment.environment": "production",
    "hostname": "chat-frontend-02.example.com"
  },
  "instrumentation": {
    "name": "wayfound-otel-sdk",
    "version": "2.0.0"
  },
  "event_type": "user_message",
  "label": "User Message",
  "description": "User asks for account balance",
  "attributes": {
    "content": "What’s my current checking account balance?",
    "language": "en-US"
  }
}
```

--------------------------------

### Query MCP Server Documentation

Source: https://docs.wayfound.ai/mcp-server

Perform an HTTP GET request to query the documentation dynamically. Include your question as the 'ask' query parameter.

```http
GET https://docs.wayfound.ai/mcp-server.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/supervisor/overview.md

To get specific information not directly on a page, make an HTTP GET request to the page URL with an 'ask' query parameter. The question should be in natural language.

```http
GET https://docs.wayfound.ai/supervisor/overview.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/supervisor/performance.md

Perform an HTTP GET request to the current page URL with the `ask` query parameter to dynamically query the documentation. The question should be specific and self-contained.

```http
GET https://docs.wayfound.ai/supervisor/performance.md?ask=<question>
```

--------------------------------

### Ask a Question via Documentation Index

Source: https://docs.wayfound.ai/llms.txt

Perform an HTTP GET request to the documentation index with the 'ask' parameter to get a direct answer to a specific question. The question should be self-contained and in natural language.

```HTTP
GET https://docs.wayfound.ai/welcome-to-wayfound.md?ask=<question>
```

--------------------------------

### Query Supervisor Documentation

Source: https://docs.wayfound.ai/supervisor

To get specific information not directly found on a page, make an HTTP GET request to the page URL with an 'ask' query parameter. The question should be clear and in natural language.

```HTTP
GET https://docs.wayfound.ai/supervisor.md?ask=<question>
```

--------------------------------

### Install Wayfound Agent Skill via Claude Code Marketplace

Source: https://docs.wayfound.ai/skills/agent-skill.md

Use this command to add the Wayfound agent skills marketplace to Claude Code.

```bash
/plugin marketplace add Wayfound-AI/wayfound-agent-skills
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/applications

Perform an HTTP GET request to query documentation dynamically. Use the 'ask' query parameter with a natural language question. The response includes the answer and relevant excerpts.

```http
GET https://docs.wayfound.ai/applications.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/getting-started.md

Use this method to ask questions about the documentation when the answer is not explicitly present on the page. The question should be specific and self-contained.

```http
GET https://docs.wayfound.ai/getting-started.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/mcp-server/overview.md

Use this method to ask questions about the documentation when the answer is not explicitly present on the current page. The question should be specific and in natural language.

```http
GET https://docs.wayfound.ai/mcp-server/overview.md?ask=<question>
```

--------------------------------

### Query Documentation via HTTP GET

Source: https://docs.wayfound.ai/accounts.md

Use this endpoint to dynamically query the documentation. Append the 'ask' query parameter with your question in natural language. The response includes a direct answer and relevant excerpts.

```http
GET https://docs.wayfound.ai/accounts.md?ask=<question>
```

--------------------------------

### Query Applications Documentation

Source: https://docs.wayfound.ai/applications

You can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter. The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

```APIDOC
## GET /applications.md

### Description
Allows users to query the documentation dynamically by asking a question.

### Method
GET

### Endpoint
/applications.md

### Parameters
#### Query Parameters
- **ask** (string) - Required - The question to ask the documentation in natural language.
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/agents/tags.md

Perform an HTTP GET request to query documentation dynamically. Use the 'ask' query parameter with a specific, self-contained question in natural language. The response includes a direct answer, relevant excerpts, and sources.

```http
GET https://docs.wayfound.ai/agents/tags.md?ask=<question>
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/skills

Perform an HTTP GET request to query documentation dynamically. Use this when the answer is not explicitly present, requires clarification, or you want to retrieve related sections.

```http
GET https://docs.wayfound.ai/skills.md?ask=<question>
```

--------------------------------

### Example Wayfound Session Data with Application Context

Source: https://docs.wayfound.ai/applications/supervise-multi-agent-systems.md

This JSON structure demonstrates how to include application and trace context within a Wayfound session. Ensure 'applicationId', 'trace_id', and 'span_id' are present for proper correlation of multi-agent session data.

```json
{
 "agentId": "22198fc5-1056-4a9d-b455-440db1249539",
 "applicationId": "7cf54242-0898-4ac1-a09c-c0e4be3f000a",
 "firstMessageAt": "2025-15-08T10:51:00.000Z",
 "lastMessageAt": "2025-15-08T10:51:00.000Z",
    "messages": [
      {
        "timestamp": "2025-15-08T10:51:00.000Z",
        "event_type": "assistant_message",
        "attributes": {
          "content": "Hello, how can I help you today?"
        },
        "context": {
            "trace_id": "123",
            "span_id": "abc"
        }
      }
    ]
}

    

```

--------------------------------

### User Feedback Event Examples (JSON)

Source: https://docs.wayfound.ai/agents/connecting-user-feedback.md

These JSON objects represent user feedback events, including 'thumbs_up_down' and 'stars' ratings, with optional comments. They can be added to 'messages' to track user satisfaction.

```json
{
    "timestamp": "2025-05-07T10:05:05Z",
    "event_type": "user_feedback",
    "label": "User Feedback (Thumbs)",
    "description": "User gave a thumbs-up on risk report",
    "attributes": {
      "feedback_type": "thumbs_up_down",
      "rating": "thumbs_up",
      "comment": "This was great!"
    }
  }
```

```json
{
    "timestamp": "2025-05-07T10:05:10Z",
    "event_type": "user_feedback",
    "label": "User Feedback (Stars)",
    "description": "User rated overall experience",
    "attributes": {
      "feedback_type": "stars",
      "rating": 5
    }
}
```

--------------------------------

### get_session_analysis

Source: https://docs.wayfound.ai/mcp-server/overview.md

Get the full session analysis and transcript (if allowed) for a specific session ID. This includes all messages, metadata, ratings, knowledge gaps, guideline violations, sentiment, and other session data.

```APIDOC
## get_session_analysis

### Description
Get the full session analysis and transcript (if allowed) for a specific session ID. This includes all messages, metadata, ratings, knowledge gaps, guideline violations, sentiment, and other session data.
```

--------------------------------

### Connect Agent and Record Messages (Python)

Source: https://docs.wayfound.ai/agents/connecting-agents.md

Use the Wayfound Python SDK to create a session with your API key and agent ID, then record a sequence of messages. Ensure you have your Wayfound API key and agent ID before running.

```python
from wayfound import Session

wayfound_api_key = "<API KEY>"
wayfound_agent_id = "<AGENT_ID>"

wayfound_session = Session(wayfound_api_key=wayfound_api_key, agent_id=wayfound_agent_id)

messages = []

messages.append({
    "timestamp": "2025-05-07T10:00:00Z",
    "event_type": "assistant_message",
    "attributes": {
      "content": "Hello, how can I help you today?",
    }
  })

messages.append({
    "timestamp": "2025-05-07T10:00:04Z",
    "event_type": "user_message",
    "attributes": {
      "content": "What's the current status of Project Alpha?"
    }
  })

result = wayfound_session.create(messages=messages)
```

--------------------------------

### Connect Agent and Record Messages (JavaScript)

Source: https://docs.wayfound.ai/agents/connecting-agents.md

Use the Wayfound JavaScript SDK to establish a session with your API key and agent ID, then record a sequence of messages. Obtain your Wayfound API key and agent ID prior to execution.

```javascript
import { Session } from "wayfound";

const wayfoundApiKey = "<API KEY>";
const agentId = "<AGENT_ID>";

const session = new Session({ wayfoundApiKey, agentId });

const messages = [
  {
    timestamp: "2025-05-07T10:00:00Z",
    event_type: "assistant_message",
    attributes: {
      content: "Hello, how can I help you today?",
    },
  },
  {
    timestamp: "2025-05-07T10:00:10Z",
    event_type: "user_message",
    attributes: {
      content: "What's the current status of Project Alpha?",
    },
  },
];

const response = await session.create({ messages });
```

--------------------------------

### Query Documentation Dynamically

Source: https://docs.wayfound.ai/agents/test-mode.md

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections. The question should be specific, self-contained, and written in natural language.

```http
GET https://docs.wayfound.ai/agents/test-mode.md?ask=<question>
```

--------------------------------

### MCP Server Configuration (API Key)

Source: https://docs.wayfound.ai/mcp-server/using.md

Configure the MCP server in your mcp.json file using an API key for authentication. Ensure the AUTH_HEADER environment variable is set correctly.

```json
{
  "mcpServers": {
    "wayfound": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.wayfound.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_MCP_API_KEY>"
      }
    }
  }
}
```

--------------------------------

### Log Human Review Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to capture a supervisor's follow-up actions after an agent handoff. Include the approver ID and the status of the review.

```json
{
  "timestamp": "2025-05-07T10:05:00Z",
  "event_type": "human_review",
  "label": "Human Review",
  "description": "Supervisor added budget commentary",
  "attributes": {
    "approver_id": "supervisor-99",
    "status": "note_added"
  }
}
```

--------------------------------

### Log User Feedback (Stars)

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to capture an overall star rating for the user's session. Include the feedback type and the star rating.

```json
{
  "timestamp": "2025-05-07T10:05:10Z",
  "event_type": "user_feedback",
  "label": "User Feedback (Stars)",
  "description": "User rated overall experience",
  "attributes": {
    "feedback_type": "stars",
    "rating": 5
  }
}
```

--------------------------------

### MCP Server Configuration (OAuth)

Source: https://docs.wayfound.ai/mcp-server/using.md

Configure the MCP server in your mcp.json file for OAuth authentication. This method does not require explicit header configuration.

```json
{
  "mcpServers": {
    "Wayfound": {
      "url": "https://app.wayfound.ai/mcp",
      "transport": "http"
    }
  }
}
```

--------------------------------

### Log Tool Call Event in JSON

Source: https://docs.wayfound.ai/agents/connecting-tool-calls.md

Use this JSON structure to log a tool call event. Include details like timestamp, event type, label, description, and attributes such as success status, tool name, latency, input, and output. Log all tool calls for accurate performance tracking.

```json
{
    "timestamp": "2025-05-07T10:00:03Z",
    "event_type": "tool_call",
    "label": "Tool Call: FlightService.SearchFlights",
    "description": "Searching for flights from SFO to JFK",
    "attributes": {
        "success": true,
        "tool_name": "FlightService",
        "latency_ms": 120,
        "tool_input": {
          "to": "SFO",
          "from": "JFK",
          "dates": [
            "2025-06-10",
            "2025-06-15"
          ]
        },
        "tool_output": [
          {
            "price": 320,
            "flight_id": "FS123"
          },
          {
            "price": 290,
            "flight_id": "FS456"
          }
        ]
      }
}
```

--------------------------------

### Log System Message Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to note background system actions, like scheduling a report. Include the content describing the system action.

```json
{
  "timestamp": "2025-05-07T10:00:12Z",
  "event_type": "system_message",
  "label": "System Message",
  "description": "Scheduled weekly status email",
  "attributes": {
    "content": "Weekly report for Project Alpha will be sent every Monday at 09:00."
  }
}
```

--------------------------------

### Log Link Click Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to log when a user clicks a link, such as navigating to a web dashboard. Include the URL that was clicked.

```json
{
  "timestamp": "2025-05-07T10:00:11Z",
  "event_type": "link_click",
  "label": "Link Click",
  "description": "User clicked through to dashboard",
  "attributes": {
    "url": "https://dashboard.example.com/projects/Alpha"
  }
}
```

--------------------------------

### Log Agent Handoff Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to mark the transfer of an interaction to a human agent. Include the reason for the handoff.

```json
{
  "timestamp": "2025-05-07T10:00:14Z",
  "event_type": "agent_handoff",
  "label": "Agent Handoff",
  "description": "Transferred to human for budget questions",
  "attributes": {
    "reason": "budget_inquiry"
  }
}
```

--------------------------------

### get_supervisor_analysis_for_agent

Source: https://docs.wayfound.ai/mcp-server/overview.md

Gain real-time insights into AI agent performance directly through popular MCP clients like Claude Desktop, Cursor, and Slack. Effortlessly track guideline adherence, performance issues, and knowledge gaps.

```APIDOC
## get_supervisor_analysis_for_agent

### Description
Gain real-time insights into AI agent performance directly through popular MCP clients like Claude Desktop, Cursor, and Slack. Effortlessly track guideline adherence, performance issues, and knowledge gaps.

### Example
Quickly identify the number and types of compliance issues within your Customer Support agents over the past week.
```

--------------------------------

### Log User Message Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Record a user's request or input during a session. Use this to capture the exact phrasing of user queries.

```json
{
  "timestamp": "2025-05-07T10:00:00Z",
  "event_type": "user_message",
  "label": "User Message",
  "description": "User asks for project Alpha status",
  "attributes": {
    "content": "What’s the current status of Project Alpha?"
  }
}
```

--------------------------------

### get_improvement_suggestions_for_agent

Source: https://docs.wayfound.ai/mcp-server/overview.md

Provide developers actionable recommendations based on real-time analytics embedded directly into IDEs like Claude Code, Cursor, Windsurf, or Zed. Continuously improve AI agent performance through practical insights.

```APIDOC
## get_improvement_suggestions_for_agent

### Description
Provide developers actionable recommendations based on real-time analytics embedded directly into IDEs like Claude Code, Cursor, Windsurf, or Zed. Continuously improve AI agent performance through practical insights.

### Example
Automatically suggest improvements to address common performance issues based on ongoing session analysis.
```

--------------------------------

### Add Wayfound MCP to Claude Code (API Key)

Source: https://docs.wayfound.ai/mcp-server/using.md

Command to add the Wayfound MCP server to Claude Code using an API key. This sets up the server with HTTP transport and includes the Authorization header.

```bash
claude mcp add --transport http wayfound https://app.wayfound.ai/mcp --header "Authorization: Bearer <YOUR_MCP_API_KEY>"
```

--------------------------------

### Log Custom Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to track domain-specific audit entries or other custom actions. Include an event name and any relevant details.

```json
{
  "timestamp": "2025-05-07T10:00:13Z",
  "event_type": "custom_event",
  "label": "Custom Event",
  "description": "Audit log entry",
  "attributes": {
    "event_name": "audit_log",
    "details": { "action": "view_status", "user": "user-007" }
  }
}
```

--------------------------------

### MCP Server Address

Source: https://docs.wayfound.ai/mcp-server/using.md

The base URL for accessing the Wayfound MCP server.

```text
https://app.wayfound.ai/mcp
```

--------------------------------

### Add Wayfound MCP to Claude Code (OAuth)

Source: https://docs.wayfound.ai/mcp-server/using.md

Command to add the Wayfound MCP server to Claude Code using OAuth. This sets up the server with HTTP transport.

```bash
claude mcp add --transport http wayfound https://app.wayfound.ai/mcp
```

--------------------------------

### Log Reasoning Step Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Capture the agent's internal thought process or decision-making steps. Useful for debugging and understanding agent logic.

```json
{
  "timestamp": "2025-05-07T10:00:01Z",
  "event_type": "reasoning_step",
  "label": "Reasoning Step",
  "description": "Determine which service to call first",
  "attributes": {
    "thought": "Fetch high-level project data, then drill into trends."
  }
}
```

```json
{
  "timestamp": "2025-05-07T10:00:08Z",
  "event_type": "reasoning_step",
  "label": "Reasoning Step",
  "description": "Decide whether to call risk agent",
  "attributes": {
    "thought": "Trend looks healthy—next get risk score."
  }
}
```

--------------------------------

### list_agents

Source: https://docs.wayfound.ai/mcp-server/overview.md

Retrieve a complete list of all Agents being supervised by Wayfound for your organization.

```APIDOC
## list_agents

### Description
Retrieve a complete list of all Agents being supervised by Wayfound for your organization.

### Example
Get a quick status update on your organization’s agents.
```

--------------------------------

### get_session_tags_for_agent

Source: https://docs.wayfound.ai/mcp-server/overview.md

Retrieve the tags and labels for an agent.

```APIDOC
## get_session_tags_for_agent

### Description
Retrieve the tags and labels for an agent.

### Example
Get a list of tags or labels that can be used for questions related to tag or label filtering.
```

--------------------------------

### Log Assistant Message Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to present information, such as a risk score, to the user. Include the content of the message, model name, token count, and latency.

```json
{
  "timestamp": "2025-05-07T10:00:10Z",
  "event_type": "assistant_message",
  "label": "Assistant Risk Report",
  "description": "Delivered risk assessment",
  "attributes": {
    "content": "Risk score for Project Alpha is 2.1/5 (Low), with schedule variance at 5%.",
    "model_name": "gpt-4",
    "tokens_total": 22,
    "latency_ms": 70
  }
}
```

--------------------------------

### Log Tool Call Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Record when an agent calls an external tool or service. Includes details about the tool, input, output, and success status.

```json
{
  "timestamp": "2025-05-07T10:00:03Z",
  "event_type": "tool_call",
  "label": "Tool Call: PMService.getProjectData",
  "description": "Fetched summary for Project Alpha",
  "attributes": {
    "tool_name": "PMService",
    "tool_input": { "projectId": "Alpha" },
    "tool_output": { "status": "On Track", "completion": 80 },
    "success": true,
    "latency_ms": 95
  }
}
```

```json
{
  "timestamp": "2025-05-07T10:00:07Z",
  "event_type": "tool_call",
  "label": "Tool Call: AnalyticsService.getCompletionTrend",
  "description": "Fetched completion trend data",
  "attributes": {
    "tool_name": "AnalyticsService",
    "tool_input": { "projectId": "Alpha" },
    "tool_output": [
      { "week": 1, "completion": 50 },
      { "week": 2, "completion": 60 },
      { "week": 3, "completion": 75 },
      { "week": 4, "completion": 80 }
    ],
    "success": true,
    "latency_ms": 110
  }
}
```

--------------------------------

### Log User Feedback (Thumbs)

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to log a thumbs-up or thumbs-down feedback from the user on a specific item. Include the feedback type, rating, and related span ID.

```json
{
  "timestamp": "2025-05-07T10:05:05Z",
  "event_type": "user_feedback",
  "label": "User Feedback (Thumbs)",
  "description": "User gave a thumbs-up on risk report",
  "attributes": {
    "feedback_type": "thumbs_up_down",
    "rating": "thumbs_up",
    "related_span_id": "span-10"
  }
}
```

--------------------------------

### evaluate_session

Source: https://docs.wayfound.ai/mcp-server/overview.md

Automatically validate AI-generated outputs before finalizing critical actions to ensure adherence to business guidelines on tone, formatting, privacy, and more.

```APIDOC
## evaluate_session

### Description
Automatically validate AI-generated outputs before finalizing critical actions. Ensure adherence to business guidelines on tone, formatting, privacy, and more.

### Example
Validate AI generated customer email responses for compliance before sending, preventing guideline violations and enhancing customer satisfaction.
```

--------------------------------

### list_sessions

Source: https://docs.wayfound.ai/mcp-server/overview.md

Retrieve sessions with provided include or exclude filtering for tags or labels.

```APIDOC
## list_sessions

### Description
Retrieve sessions with provided include or exclude filtering for tags or labels.

### Example
Get a list of sessions for a given tag/label query.
```

--------------------------------

### Log Agent Call Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Use this event to log a request for a detailed risk assessment from a RiskAgent. Include the external ID of the agent and the input parameters for the assessment.

```json
{
  "timestamp": "2025-05-07T10:00:09Z",
  "event_type": "agent_call",
  "label": "Agent Call: RiskAgent",
  "description": "Requested project risk evaluation",
  "attributes": {
    "external_id": "agent-42",
    "input": { "projectId": "Alpha" }
  }
}
```

--------------------------------

### Log Button Click Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Record when a user clicks a button within the interface. Captures the ID of the clicked button for tracking user interactions.

```json
{
  "timestamp": "2025-05-07T10:00:06Z",
  "event_type": "button_click",
  "label": "Button Click",
  "description": "User chose to view trend",
  "attributes": {
    "button_id": "trend"
  }
}
```

--------------------------------

### get_agent_details

Source: https://docs.wayfound.ai/mcp-server/overview.md

Retrieve the details of a specific Agent in your Wayfound organization. Includes the agent’s role, goal, guidelines, and sentiment tuning.

```APIDOC
## get_agent_details

### Description
Retrieve the details of a specific Agent in your Wayfound organization. Includes the agent’s role, goal, guidelines, and sentiment tuning.

### Example
Understand how each agent is configured and what their purpose in your organization is.
```

--------------------------------

### Log Assistant Message Event

Source: https://docs.wayfound.ai/agents/connecting-other-events.md

Record messages generated by the assistant or AI. Includes content, model used, token count, and latency.

```json
{
  "timestamp": "2025-05-07T10:00:04Z",
  "event_type": "assistant_message",
  "label": "Assistant Summary",
  "description": "Reported high-level status",
  "attributes": {
    "content": "Project Alpha is On Track with 80% completion to date.",
    "model_name": "gpt-4",
    "tokens_total": 18,
    "latency_ms": 60
  }
}
```
Tokens:
Raw