{
  "_": "╔══════════════════════════════════════════════════════════════╗",
  "__": "║           ProCalc.ai MCP Server — Discovery Document        ║",
  "___": "╚══════════════════════════════════════════════════════════════╝",
  "_about": "This is a live Model Context Protocol (MCP) server. POST JSON-RPC messages to interact with 9 data tools. GET (this page) returns the discovery document. No API key needed.",
  "name": "procalc-mcp-server",
  "version": "1.0.1",
  "app_version": "21.38.9",
  "build_id": "b12apr12a",
  "description": "The precision data layer for AI. 9,267 verified records across materials, names, elements, and calculators — queryable by any MCP client.",
  "provider": {
    "name": "ProCalc.ai",
    "url": "https://procalc.ai",
    "contact": "jerry@croteau.com"
  },
  "_protocol_note": "MCP is an open standard by Anthropic for connecting AI to data. Any compatible client can connect — Claude Desktop, Cursor, Windsurf, VS Code, Claude Code.",
  "protocol": {
    "name": "Model Context Protocol (MCP)",
    "spec": "https://modelcontextprotocol.io",
    "version": "2025-03-26",
    "transport": "streamable-http",
    "endpoint": "https://procalc.ai/api/mcp",
    "method": "POST",
    "content_type": "application/json",
    "response_format": "text/event-stream (SSE)"
  },
  "_auth_note": "No API key needed. Just POST to the endpoint. Free during beta.",
  "authentication": {
    "required": false,
    "type": "none (beta)",
    "future": "API key via x-api-key header (Q3 2026)"
  },
  "_tools_note": "9 tools. Each returns structured markdown with source attribution. Use tools/list for full input schemas.",
  "tools": [
    {
      "name": "procalc_material_lookup",
      "description": "Physical properties for 103 verified materials — density, hardness, melting point, formula, applications.",
      "example_input": {
        "name": "granite"
      },
      "example_output": "Granite — 168 lb/ft³ (2691 kg/m³), Mohs 6.5, melts 1260°C, SiO₂ + feldspars"
    },
    {
      "name": "procalc_material_search",
      "description": "Search materials by category or keyword. Categories: Metals, Wood, Stone, Plastics, Glass, Composite, Aggregate, Insulation, Stone Veneer, Precious Metal.",
      "example_input": {
        "category": "Wood"
      },
      "example_output": "20 materials — Ash, Bamboo, Birch, Cedar, Cherry, Douglas Fir, Ebony..."
    },
    {
      "name": "procalc_calculate_weight",
      "description": "Weight from material + dimensions. Rectangular or cylindrical (solid or hollow pipe).",
      "example_input": {
        "material": "mdf",
        "length": 96,
        "width": 48,
        "thickness": 0.75,
        "shape": "rectangular"
      },
      "example_output": "MDF 96×48×0.75 in — 96.00 lbs (43.54 kg)"
    },
    {
      "name": "procalc_material_compare",
      "description": "Side-by-side comparison table of two materials.",
      "example_input": {
        "material_a": "aluminum",
        "material_b": "copper"
      },
      "example_output": "Aluminum 168.5 lb/ft³ vs Copper 559 lb/ft³, Mohs 2.8 vs 3, melts 660°C vs 1085°C"
    },
    {
      "name": "procalc_name_lookup",
      "description": "Name meaning, origin, famous bearers, related names, and name days across 8 countries.",
      "example_input": {
        "name": "gerald"
      },
      "example_output": "Gerald — 'Ruler with a spear' (Germanic), top-20 USA 1930s-50s. Name days: Dec 5 (DE/PL), Apr 19 (US)"
    },
    {
      "name": "procalc_nameday_today",
      "description": "Names celebrated today (or any date) across US, Poland, Germany, Spain, Italy, France, Sweden, Greece.",
      "example_input": {
        "month": 4,
        "day": 12
      },
      "example_output": "Apr 12 — Germany: Herta, Julius, Zeno | Poland: Andrzej, Juliusz, Zenon | US: Destiny, Walker..."
    },
    {
      "name": "procalc_nameday_search",
      "description": "Find when a name is celebrated in each country.",
      "example_input": {
        "name": "maria"
      },
      "example_output": "Maria — 39 entries: Germany Jan 1, Feb 11, Aug 5... Poland Jan 23, Feb 2... Greece Aug 15..."
    },
    {
      "name": "procalc_element_lookup",
      "description": "All 118 elements — mass, density, melting/boiling point, electron config, uses, fun facts.",
      "example_input": {
        "query": "gold"
      },
      "example_output": "Gold (Au) #79 — 19.282 g/cm³, melts 1064°C. Fun fact: all gold ever mined fits in 3.5 Olympic pools."
    },
    {
      "name": "procalc_calculator_find",
      "description": "Find ProCalc calculators by topic. Returns name, URL, domain, description.",
      "example_input": {
        "query": "construction"
      },
      "example_output": "9 calculators — Granite Weight, MDF Weight, Stone Veneer... at procalc.ai/construction/..."
    }
  ],
  "_data_note": "9,267 total verified records. Curated from authoritative sources — not scraped.",
  "data": {
    "total_records": 9267,
    "materials": {
      "rows": 103,
      "source": "ASTM, manufacturer specs, engineering handbooks"
    },
    "name_profiles": {
      "rows": 369,
      "source": "Etymological dictionaries, historical records"
    },
    "name_days": {
      "rows": 8638,
      "source": "National calendars — US, PL, DE, ES, IT, FR, SE, GR"
    },
    "elements": {
      "rows": 118,
      "source": "IUPAC, NIST, peer-reviewed chemistry references"
    },
    "calculators": {
      "rows": 41,
      "source": "ProCalc.ai live directory"
    }
  },
  "_quickstart_note": "Fastest way: paste the curl below into your terminal. Or add the URL to any MCP client.",
  "quickstart": {
    "curl": "curl -X POST https://procalc.ai/api/mcp -H \"Content-Type: application/json\" -H \"Accept: application/json, text/event-stream\" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"procalc_material_lookup\",\"arguments\":{\"name\":\"granite\"}}}'",
    "steps": [
      "POST initialize with protocolVersion '2025-03-26'",
      "POST tools/list to discover all 9 tools and their schemas",
      "POST tools/call with tool name and arguments"
    ]
  },
  "_connect_note": "Copy-paste configs for popular MCP clients:",
  "connect": {
    "claude_desktop": {
      "_how": "Add to claude_desktop_config.json → restart Claude Desktop.",
      "_path_mac": "~/Library/Application Support/Claude/claude_desktop_config.json",
      "_path_win": "%APPDATA%\\Claude\\claude_desktop_config.json",
      "config": {
        "mcpServers": {
          "procalc": {
            "type": "url",
            "url": "https://procalc.ai/api/mcp"
          }
        }
      }
    },
    "cursor": "Settings > MCP Servers > Add URL > https://procalc.ai/api/mcp",
    "windsurf": "Settings > MCP > Add Server > https://procalc.ai/api/mcp",
    "vs_code": {
      "file": ".vscode/mcp.json",
      "config": {
        "servers": {
          "procalc": {
            "type": "sse",
            "url": "https://procalc.ai/api/mcp"
          }
        }
      }
    },
    "claude_code": {
      "file": ".mcp.json",
      "config": {
        "mcpServers": {
          "procalc": {
            "type": "url",
            "url": "https://procalc.ai/api/mcp"
          }
        }
      }
    }
  },
  "rate_limits": {
    "requests_per_minute": 30,
    "note": "Contact jerry@croteau.com for higher limits."
  },
  "changelog": [
    {
      "version": "1.0.1",
      "date": "2026-04-12",
      "changes": "Fixed calculator URLs (now /{domain}/{slug}), added domain search to calculator_find, fixed cylindrical weight calc dimensions."
    },
    {
      "version": "1.0.0",
      "date": "2026-04-12",
      "changes": "Initial release — 9 tools: material lookup/search/compare/weight, name lookup/nameday today/nameday search, element lookup, calculator find."
    }
  ],
  "status": "operational",
  "links": {
    "homepage": "https://procalc.ai",
    "mcp_endpoint": "https://procalc.ai/api/mcp",
    "docs": "https://procalc.ai/developers",
    "github": "https://github.com/G2GolfFl/procalcai",
    "llms_txt": "https://procalc.ai/llms.txt",
    "llms_full": "https://procalc.ai/llms-full.txt"
  },
  "license": "Free during beta — attribution requested: 'Source: ProCalc.ai'",
  "terms": "Data provided as-is. Always verify critical engineering values independently."
}