Skip to content

docs: rewrite Alchemy MCP Server page with remote server + multi-agent setup#1190

Merged
lohnim merged 17 commits intomainfrom
chris/alchemy-mcp-server
Apr 8, 2026
Merged

docs: rewrite Alchemy MCP Server page with remote server + multi-agent setup#1190
lohnim merged 17 commits intomainfrom
chris/alchemy-mcp-server

Conversation

@lohnim
Copy link
Copy Markdown
Contributor

@lohnim lohnim commented Apr 7, 2026

Summary

  • Rewrites the Alchemy MCP Server doc to feature the new remote Streamable HTTP server (mcp.alchemy.com/mcp) as the recommended setup — OAuth sign-in, no API key or install needed
  • Adds setup instructions for 7 AI coding agents: Claude Code, Claude Desktop, Cursor, VS Code Copilot, Windsurf, OpenAI Codex, and Cline (plus a generic "any MCP client" section)
  • Preserves local STDIO setup as a secondary option in a tabbed interface
  • Expands tool reference from 9 tools to all 148 tools organized in collapsible accordion sections (Admin, RPC sub-groups, Data sub-groups)
  • Updates supported chain count from 50+ to 70+
  • Updates the Build with AI overview page to match new numbers and client list

Test plan

  • Verify page renders correctly in docs preview (tables, tabs, accordions)
  • Confirm all remote server URLs resolve (https://mcp.alchemy.com/mcp)
  • Spot-check tool names against the actual MCP server source
  • Test at least one client config (e.g. Claude Code claude mcp add command)

🤖 Generated with Claude Code

…-tool reference

Add remote Streamable HTTP server (mcp.alchemy.com) as the recommended setup with
OAuth authentication. Include setup instructions for Claude Code, Claude Desktop,
Cursor, VS Code Copilot, Windsurf, Codex, and Cline. Expand tool reference from 9
to all 148 tools organized in collapsible sections. Update chain count from 50+ to 70+.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lohnim lohnim requested a review from a team as a code owner April 7, 2026 21:45
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 7, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Apr 8, 2026, 8:51 PM

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 9eb2dd8da7

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

### OpenAI Codex

```bash
codex --mcp-server-url https://mcp.alchemy.com/mcp
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Replace unsupported Codex flag for remote MCP setup

The command codex --mcp-server-url https://mcp.alchemy.com/mcp uses a top-level flag that is not part of Codex CLI MCP configuration, so users following this step will hit an unknown-option failure and never add the server. The Codex CLI reference documents MCP setup via codex mcp add <name> --url <value> (and codex mcp list to verify), so this instruction should use that flow.

Useful? React with 👍 / 👎.

Comment on lines +107 to +113
"mcpServers": {
"alchemy": {
"type": "streamable-http",
"url": "https://mcp.alchemy.com/mcp"
}
}
}
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Use Codex config format that Codex actually loads

This snippet is presented as “your Codex config” but uses JSON mcpServers; Codex stores MCP servers in ~/.codex/config.toml under mcp_servers, so this block will not be read by Codex and users will think they configured MCP when they have not. The docs should show the TOML shape (or direct users to codex mcp add ...) to avoid a broken setup path.

Useful? React with 👍 / 👎.

{
"servers": {
"alchemy": {
"type": "streamable-http",
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Set VS Code remote MCP type to a supported value

VS Code’s mcp.json schema expects remote servers to use "type": "http" (or "sse"), but this config uses "streamable-http"; that value is not documented as valid and can prevent server startup/validation in Copilot Agent mode. Updating this to the supported transport type avoids a non-working VS Code configuration.

Useful? React with 👍 / 👎.

lohnim and others added 2 commits April 7, 2026 17:51
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 7, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 7266
✅ Successful 6143
⏳ Timeouts 0
🔀 Redirected 394
👻 Excluded 677
❓ Unknown 0
🚫 Errors 52
⛔ Unsupported 0
Broken links (52) — click to expand

Errors per input

Errors in ./content/changelog/2026-03-26.md

Errors in ./content/api-reference/hyperevm/hyperevm-api-overview.mdx

Errors in ./content/wallets/pages/bundler-api/bundler-faqs.mdx

Errors in ./content/api-reference/arbitrum/arbitrum-api-faq/arbitrum-api-faq.mdx

Errors in ./content/api-reference/op-mainnet/op-mainnet-api-faq/op-mainnet-api-faq.mdx

View workflow run

lohnim and others added 10 commits April 7, 2026 17:53
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Merge Cursor, Cline, and Windsurf into one tab since they share the
same JSON config. Reduces from 8 tabs to 5. Move generic client note
to text below tabs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix Codex CLI command to use `codex mcp add` instead of unsupported flag
- Fix VS Code Copilot type from "streamable-http" to "http"
- Update network count from 70+ to 100+ everywhere

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add numbered steps for Claude Code (restart + /mcp to verify),
Codex (codex mcp list), and Cursor/Cline/Windsurf (restart + settings).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
lohnim and others added 2 commits April 8, 2026 16:10
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@lohnim lohnim merged commit 55592a7 into main Apr 8, 2026
7 of 8 checks passed
@lohnim lohnim deleted the chris/alchemy-mcp-server branch April 8, 2026 20:59
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