businessmcp — Claude Code MCP server: features and setup
A set of MCP gateway utilities that checks upstream URLs, classifies failures, and keeps namespaced tool names distinct.
claude mcp add --transport http businessmcp https://businessmcp.com/api/mcpWhat businessmcp does
A gateway may fetch a third-party MCP server URL supplied by a user. isPublicHttpUrl resolves the host and accepts it only when every returned address is public; isBlockedIp also handles IPv4 addresses embedded in IPv6. DNS rebinding can still happen between the check and the socket connection. Redirects need separate validation at every hop.
classifyUpstreamError distinguishes authentication, transport, timeout, blocked-host, and unreachable failures. describeFailure turns a failure into a message for the user. namespacedToolName prefixes tool names and appends a short hash when truncation is needed. withUpstream tries Streamable HTTP, then SSE, and reports which transport worked. That helper requires @modelcontextprotocol/client; the other modules do not.
This is a utility package, not a complete gateway: it does not provide aggregation, authentication, or a policy layer. The DNS check leaves a time-of-check/time-of-use risk before the connection is made.
What it helps with
- check an MCP server URL before fetching it
- identify why an upstream connection failed
- show users a readable failure message
- avoid collisions between namespaced tools
- fall back to a supported upstream transport
Example prompts for the agent
- Check whether this MCP server URL resolves only to public IP addresses.
- Explain the upstream connection failure in a message for the user.
- Namespace these tools so their names remain distinct.
How to install businessmcp
Platform CLI: remote server
claude mcp add --transport http businessmcp https://businessmcp.com/api/mcpPlatform CLI: remote server
codex mcp add businessmcp --url https://businessmcp.com/api/mcpConfig file
{
"mcpServers": {
"businessmcp": {
"url": "https://businessmcp.com/api/mcp"
}
}
}Config file
{
"servers": {
"businessmcp": {
"type": "http",
"url": "https://businessmcp.com/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http businessmcp https://businessmcp.com/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about businessmcp
How do I install businessmcp in Claude Code?
Run claude mcp add --transport http businessmcp https://businessmcp.com/api/mcp.
What does businessmcp do?
It provides MCP gateway utilities for URL checks, upstream failure classification, tool naming, and transport fallback.
Does businessmcp need @modelcontextprotocol/client?
Only withUpstream requires @modelcontextprotocol/client. The other modules do not.
