Repository avatar
AI Tools
v0.1.2
active

free

com.visdenda/free

Anonymous SEO MCP: crawler directory, robots.txt, llms.txt, update radar, page scan. No API key.

Documentation

@visdenda/mcp-free-bridge

Zero-dependency stdio bridge for the anonymous Visdenda MCP server. It lets MCP clients that only speak stdio use the hosted endpoint at https://visdenda.com/v1/mcp/free.

The package is a thin proxy, not a second implementation: it forwards newline-delimited JSON-RPC from stdin to the remote Streamable HTTP endpoint and writes the response back to stdout. The hosted endpoint remains the source of truth for tools, prompts, results, quotas, and protocol behavior.

Requirements

  • Node.js 18 or newer (uses the built-in fetch).

Run

Normally your MCP client spawns the bridge for you:

npx -y @visdenda/mcp-free-bridge

To run it directly from this package:

pnpm start

The process reads JSON-RPC messages from stdin and writes JSON-RPC responses to stdout, one JSON object per line. Diagnostics go to stderr only.

Claude Desktop

Add a server to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "visdenda-free": {
      "command": "npx",
      "args": ["-y", "@visdenda/mcp-free-bridge"]
    }
  }
}

On Windows, Claude Desktop may require wrapping the command:

{
  "mcpServers": {
    "visdenda-free": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@visdenda/mcp-free-bridge"]
    }
  }
}

Restart Claude Desktop after editing the file.

Cursor

Use the same mcpServers shape in ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "visdenda-free": {
      "command": "npx",
      "args": ["-y", "@visdenda/mcp-free-bridge"]
    }
  }
}

VS Code

VS Code uses a servers object and an explicit stdio type in .vscode/mcp.json:

{
  "servers": {
    "visdenda-free": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@visdenda/mcp-free-bridge"]
    }
  }
}

Configuration

VariableDefaultPurpose
VISDENDA_MCP_URLhttps://visdenda.com/v1/mcp/freeOverride the remote endpoint, for local development or testing.
VISDENDA_MCP_TIMEOUT_MS60000Per-request timeout; a stalled request cannot wedge the process.

Example for a local backend:

{
  "mcpServers": {
    "visdenda-free": {
      "command": "npx",
      "args": ["-y", "@visdenda/mcp-free-bridge"],
      "env": { "VISDENDA_MCP_URL": "http://127.0.0.1:3102/v1/mcp/free" }
    }
  }
}

Behavior

  • Requests (messages with an id) are POSTed to the endpoint with content-type: application/json and accept: application/json, text/event-stream.
  • JSON responses are written as one line. Server-Sent Events responses are reduced to the last data: JSON event.
  • Notifications (messages without an id) are forwarded, and no response is written.
  • Error responses from the endpoint are passed through unchanged, so quota errors keep their JSON-RPC code, data.code and retryAfterSeconds.
  • Network failures, timeouts and non-JSON error responses become a JSON-RPC error with the same id and code -32000; the process keeps running.
  • Each message is sent in order, one at a time, so a slow tools/call delays later messages rather than interleaving them.
  • Nothing except JSON-RPC responses is written to stdout.

Limits

The remote endpoint is anonymous: no API key or account is required. It is rate-limited per client IP, currently 100 database-backed calls and 5 network calls per UTC day, plus 3 page scans and 30 requests a minute. Calls that exceed the limit return HTTP 429 with JSON-RPC -32003 and Retry-After. See https://visdenda.com/mcp/free for the current limits and tool documentation.

Publishing (maintainers)

server.json is the MCP Registry manifest for the remote-only free server; its version must match package.json and publish.mjs --check enforces that along with the public repository URL.

npm publishes from the public mirror repository (visdenda/mcp-free-bridge), not from the private monorepo: only a public repository can produce npm provenance. A version bump merged to main is mirrored automatically, tagged, and published by the mirror's workflow.

pnpm --filter @visdenda/mcp-free-bridge check:package   # local pre-flight, no network

Registry publishing stays manual (run it where server.json lives: this directory in the source monorepo, the repository root in the public mirror):

mcp-publisher login dns --domain visdenda.com   # one-time namespace verification
mcp-publisher publish                            # reads ./server.json

The full launch order (org and mirror setup, npm → registry → directories, copy blocks and the pre-publish checklist) lives in the repository at docs/operations/public-distribution.md and docs/seo/link-building/mcp-free-launch/README.md.

License

MIT

Source

This repository is the public source mirror of @visdenda/mcp-free-bridge. Development happens in a private monorepo; fixes are ported here before a release, and npm publishes from this repository with provenance. The hosted endpoint itself is documented at https://visdenda.com/mcp/free. Issues are welcome here.

No installation packages available.