Skip to content

Conversation

@masnwilliams
Copy link
Contributor

@masnwilliams masnwilliams commented Sep 17, 2025

TL;DR

Updates the MCP Server reference documentation to reflect the latest available tools and resources.

Why we made these changes

To ensure our documentation is accurate and up-to-date for developers using the MCP Server API. Outdated information about available tools and resources can lead to integration errors and confusion.

What changed?

  • Modified reference/mcp-server.mdx to update the lists of supported tools and resources.
  • Added entries for newly available API tools.
  • Removed deprecated or outdated listings.

Description generated by Mesa. Update settings

Copy link
Contributor

@mesa-dot-dev mesa-dot-dev bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Performed full review of a06ba3a...2847f29

Analysis

  1. The PR focuses primarily on documentation updates rather than actual implementation of the new browser profile management capabilities, which may create a mismatch between documented features and actual functionality.

  2. Adding persistent profile management introduces potential security and privacy concerns that aren't addressed in the architectural description, particularly regarding how user data is stored and protected.

  3. The expansion of server functionality beyond basic browser automation represents a significant scope increase that could impact server performance, resource utilization, and maintenance complexity.

  4. The PR description lacks details on how these new capabilities integrate with the existing codebase architecture, potentially leading to inconsistent implementation patterns.

Tip

⚡ Quick Actions

This review was generated by Mesa.

Actions:

Slash Commands:

  • /review - Request a full code review
  • /review latest - Review only changes since the last review
  • /describe - Generate PR description. This will update the PR body or issue comment depending on your configuration
  • /help - Get help with Mesa commands and configuration options

1 files reviewed | 3 comments | Review on Mesa | Edit Reviewer Settings


## Resources

- `profiles://` - Access browser profiles (list all or get specific profile)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Medium Style

The resources section could benefit from more detailed explanations. Consider adding example URIs (e.g., 'profiles://profile-name' or 'browsers://browser-id') to show users the expected format for accessing specific resources.
Agent: 🤖 General

Human: I'm done setting up my accounts
Assistant: Perfect! I'll close the browser session and save your profile.
[Uses delete_browser tool to save profile]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Medium Logic

The example shows using delete_browser to save a profile, but this might be confusing. Consider clarifying that this closes the setup session and saves the profile, or mention if there's a dedicated save/finalize step.
Agent: 🤖 General

Copy link
Contributor

@dprevoznik dprevoznik left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - I'd consider in the future beginning to separate out this long page into separate shorter pages within the MCP section. e.g. Setup & Clients, Tools & Resources, Help & Examples

@masnwilliams masnwilliams merged commit 206c535 into main Sep 18, 2025
3 checks passed
@masnwilliams masnwilliams deleted the mason/mcp-docs-updates branch September 18, 2025 15:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants