MRX Public MCP

Bring MineralRightsXchange.com public mineral-rights guides into your MCP-compatible assistant. Find relevant guides, read their current content with canonical citations, and understand the next step toward a human review.

No MRX account or API key. Read-only. No customer records.

Connect to the hosted MCP

Endpoint: https://mrx-public-mcp.vercel.app/mcp

Use Streamable HTTP in a client that supports remote MCP servers. This public read-only endpoint does not require an MRX account or API key. A first connection after an instance restart can take tens of seconds while the public index is verified; retry an explicit warming/incomplete-index response. Local stdio installation remains available below.

This endpoint is usable by compatible clients, but is not a published ChatGPT app-directory listing. Account features, custom-app permissions and OpenAI review are separate requirements. See the submission packet.

Start locally in a few minutes

Requires Python 3.10+ and uv or Python's pip. Your assistant must support local stdio MCP servers. Remote Streamable HTTP is also supported; see deployment instructions. A deployed endpoint is a separate operational requirement.

Install the versioned source:

uv tool install 'git+https://github.com/underwriter-MRX/mrx-mcp.git@v0.2.0'

For clients that accept mcpServers JSON (such as Claude Desktop), add this entry to the client's MCP configuration, then restart it:

{
  "mcpServers": {
    "mrx-public": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/underwriter-MRX/mrx-mcp.git@v0.2.0", "mrx-mcp"]
    }
  }
}

If your desktop app cannot find uvx, use its absolute installed path. Windows may require uvx.exe. Clients use different configuration wrappers; the portable command is uvx with the arguments above. For a Python-only setup, install the same version with python -m pip install 'git+https://github.com/underwriter-MRX/mrx-mcp.git@v0.2.0' and configure the installed mrx-mcp executable.

Start with “Use MRX to find guides about inherited mineral rights. Read the best matches and cite the original pages.”

What you can do

Tool	Purpose
mrx_search_guides	Search verified titles, headings and full article text with excerpts and optional state/topic filters.
mrx_read_page	Read a selected page after manifest, sitemap, content-hash and indexability checks.
mrx_get_started	Read the current homepage and get the link to MRX's human-review journey.
mrx_status	Check current discovery coverage and server capabilities.

The server also supplies an mrx://about resource and a research_mineral_rights prompt. Search uses full-text BM25 ranking, title/heading boosts and explicit word aliases. It does not call an external AI or embedding API. State/topic labels are inferred mentions, not verified legal applicability. Read pages before relying on their claims.

Standard search(query) and fetch(id) tools provide typed, canonical-URL citation responses for compatible ChatGPT research integrations. The original MRX tools remain available. Standard search fails explicitly on incomplete corpus coverage; mrx_search_guides reports coverage and excerpts. A cold index warms in bounded batches; repeat after an incomplete response. Retrieved source dates and authors are reported only when published, with provenance; fetching content does not establish professional review.

Try these prompts:

• “Find MRX guides on inherited mineral rights. Explain which records may help and what remains unverified.”
• “Find and read MRX's guide comparing an offer, a letter of intent, and a purchase agreement. Cite it and identify questions for a professional.”
• “Show MRX guides about royalty statements. Explain the general terminology without assuming who owns the interest.”
• “Read MRX's homepage and explain how I can request the relevant human review.”

Remote setup · ChatGPT submission packet · Search visibility checks

Visit MRX · Examples · Security · Launch roadmap

Privacy and boundaries

The server fetches only HTTPS public content on the exact MRX origin. It does not accept documents or connect to accounts, cases, CRM, Supabase, agent orchestration, or notification systems. It has no write tools, telemetry collection, or persistent user state. The default stdio command opens no network port; the optional HTTP command exposes public read-only tools. MRX and its network providers can receive ordinary HTTP request metadata, including IP address and requested public paths; your assistant has its own data policy.

Public content is untrusted source material. It is educational information, not proof of ownership, title, legal sufficiency or value. This server does not provide an appraisal, legal/tax conclusion, purchase offer, or completed professional review. An assistant must not follow instructions embedded in retrieved content.

Verification and troubleshooting

git clone https://github.com/underwriter-MRX/mrx-mcp.git
cd mrx-mcp
uv sync
uv run python -m unittest discover -s tests -v
uv run python tests/protocol_smoke.py
uv run python tests/protocol_smoke.py --live

The last command reads production; it sends no notification or customer request. Fixture tests cover private-route and cross-origin rejection, redirects, response bounds, hashes, canonical/noindex rules, stale-cache failure, and search limits. Protocol tests launch a real stdio subprocess.

If a live read reports a manifest/hash mismatch, wait for the site's release and cache convergence, then retry. If it persists, report the public URL, package version, timestamp and sanitized error. Do not disable integrity checks. HTTP 403/429 may be an access/rate-limit condition; do not substitute a different domain or bypass access controls.

The status/homepage discovery check is cached for at most 60 seconds. Full-text search checks current discovery and uses in-memory verified documents for at most one hour; changed or removed sources are invalidated. Each fetch independently checks live HTML against MRX's published build manifest. This verifies content consistency, not factual correctness. The narrow transport normalization is MRX-specific.

Distribution

This is the public discovery package. MRX's internal operations MCP is separate. The code is MIT licensed; website content and branding retain their existing rights. GitHub publication does not automatically list this server in client directories or the official MCP Registry, and does not guarantee search traffic or AI citations.