{"id":"gabrielserrao-pyrestoolbox-mcp","name":"pyrestoolbox-mcp","homepage":null,"repo_url":"https://github.com/gabrielserrao/pyrestoolbox-mcp","category":"ai-ml","subcategories":[],"tags":["mcp","fastmcp","python","reservoir-engineering","pvt","well-performance","petroleum","ai-tooling","tool-calling"],"what_it_does":"Provides a local Model Context Protocol (MCP) server (FastMCP-based) that exposes ~108 reservoir engineering / petroleum engineering calculation tools by bridging AI agents (e.g., Claude Desktop) to the pyResToolbox library for tasks like PVT, well performance/IPR, nodal/VLP, DCA, material balance, geomechanics, brine properties, and related workflows.","use_cases":["AI-assisted reservoir engineering calculations (PVT properties, bubble point, black-oil tables)","Generating IPR curves and well performance outputs from natural-language prompts","Preparing inputs for reservoir simulators (e.g., relative permeability tables, black oil tables, aquifer influence functions)","Nodal/VLP calculations for deviated and horizontal completions","Geomechanics/wellbore stability calculations via MCP tool calls","Education/research workflows combining reservoir engineering computations with LLM-driven analysis"],"not_for":["Production web applications requiring authenticated multi-tenant access over HTTP from a centralized service (based on provided info)","Environments that require guaranteed compliance certifications or auditable security posture beyond basic OSS usage guidance","Use as a high-assurance engineering component without independent validation/testing (calculations depend on models/correlations and user inputs)"],"best_when":"You have a local or controlled environment (e.g., Claude Desktop) and want an MCP-compatible agent to call strongly-scoped reservoir engineering functions without writing Python glue code.","avoid_when":"You need a managed, internet-hosted API with centralized access control, guaranteed rate limiting, or formal SLA/SLA-backed uptime guarantees.","alternatives":["Direct pyResToolbox usage via Python scripts/notebooks","Other MCP servers or agent tool integrations that wrap reservoir engineering libraries","Custom FastAPI/REST wrappers around pyResToolbox (with your own auth/rate limiting)"],"af_score":60.5,"security_score":37.2,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:26:22.188610+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["Python"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["No documented auth for local MCP (based on README)"],"oauth":false,"scopes":false,"notes":"README describes connecting via Claude Desktop by launching the MCP server locally; no authentication mechanism, tokens, or scopes are documented in the provided content."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source; no hosted pricing described in provided content."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.5,"security_score":37.2,"reliability_score":36.2,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":5.0,"tls_enforcement":0.0,"auth_strength":30.0,"scope_granularity":20.0,"dependency_hygiene":65.0,"secret_handling":80.0,"security_notes":"No network auth/TLS details are provided because the MCP server is intended to run locally via Claude Desktop launch configuration. This can be acceptable for a single-user workstation but may be risky if exposed beyond localhost. No explicit secret management guidance is shown; ensure you do not place credentials in command args/logs if you extend the server.","uptime_documented":0.0,"version_stability":70.0,"breaking_changes_history":40.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"Not specified; most calculations appear pure/functional, but no idempotency semantics are documented for tool calls.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Tool parameter naming/method enum strings must match the provided skill/tools-reference; natural-language paraphrases may fail validation.","Unit handling (field vs metric) matters; incorrect units will lead to incorrect engineering outputs.","Because this is a local MCP server, operational issues may stem from environment setup (Python/uv paths, dependencies) rather than API usage."]}}