Skip to content

docs(mcp): refresh Celo MCP Server page for remote HTTP transport and current tool set - #2288

Open
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/refresh-celo-mcp-page
Open

docs(mcp): refresh Celo MCP Server page for remote HTTP transport and current tool set#2288
GigaHierz wants to merge 1 commit into
mainfrom
GigaHierz/refresh-celo-mcp-page

Conversation

@GigaHierz

Copy link
Copy Markdown
Contributor

What & why

The Celo MCP Server page had drifted from the upstream celo-org/celo-mcp repo. Two upstream changes in particular were not reflected in the docs:

  • Remote MCP support — the server now runs as a remote endpoint over Streamable HTTP (single URL, no local Python install). The page documented only the local stdio setup.
  • mcp 2.x migration — the entry point changed and the tool set was reworked.

This is a separate change from #2287 (which adds the third-party Celina pages and only cross-links this page).

Changes

  • Remote transport: new "Connect Remotely (Streamable HTTP)" section — HTTP run commands, URL-based client config, and the env-var configuration table (MCP_TRANSPORT, HOST/PORT, MCP_ALLOWED_HOSTS, MCP_CORS_ORIGINS, rate limiting, MCP_AUTH_TOKEN) plus the /health note.
  • Available Tools reconciled to the server's actual 15 tools:
    • Removed tools no longer registered upstream: get_account, get_token_info, get_nft_info, get_nft_balance, call_contract_function, estimate_contract_gas, estimate_transaction.
    • Added missing tools: get_stable_token_balance, get_staking_balances, get_activatable_stakes, get_total_staking_info, get_validator_groups, get_validator_group_details.
  • Key Features & intro corrected to the current read-only capabilities (removed NFT / smart-contract / transaction-simulation claims that no longer apply).
  • Run command updated to celo-mcp-server; Code Quality section updated to ruff (was isort/flake8).
  • MCP index page: refreshed the Celo MCP Server summary bullet (balances, staking/validators, local-or-remote).

Verification

  • Tool names, transport flags, and env-var table verified against the current celo-org/celo-mcp main (src/celo_mcp/server.py, pyproject.toml, README.md).
  • mint broken-links passes on this branch head.

🤖 Generated with Claude Code

… current tool set

Reconcile the Celo MCP Server page with the upstream celo-org/celo-mcp
repository, which has drifted from the docs:

- Document the remote Streamable HTTP transport (added upstream), including
  the HTTP run commands, URL-based client config, and env-var configuration
  table (MCP_TRANSPORT, HOST/PORT, MCP_ALLOWED_HOSTS, auth token, etc.).
- Replace the Available Tools list with the server's actual 15 tools:
  drop tools no longer registered (get_account, get_token_info, both NFT
  tools, both contract tools, estimate_transaction) and add the missing
  balances/staking/validator tools (get_stable_token_balance,
  get_staking_balances, get_activatable_stakes, get_total_staking_info,
  get_validator_groups, get_validator_group_details).
- Correct Key Features and the intro to match read-only capabilities
  (remove NFT/smart-contract/simulation claims that no longer apply).
- Update the run command to the current entry point (celo-mcp-server) and
  the Code Quality section to ruff (replacing isort/flake8).
- Refresh the summary bullet on the MCP index page.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

2 participants