ground

<main>
    <section class="hero">
        <h1>Reference data for AI</h1>
        <p class="lead">
            Ground provides structured, accurate data that AI assistants access directly via MCP.
            Classification systems, hierarchical encodings, and real-world catalogs —
            the kind of precise information that's too specialized and hit-or-miss for training data and too structured to work well in web searches.
        </p>
        <div class="cta-group">
            <a href="https://api.ground.fyi/auth/register" class="btn btn-primary">Get Started</a>
            <a href="https://api.ground.fyi/docs" class="btn btn-secondary">API Documentation</a>
        </div>
    </section>

    <section>
        <h2>What's available</h2>
        <p>Ground currently covers three types of reference data, with more in development.</p>

        <div class="stats-grid">
            <div class="stat">
                <div class="stat-value">360+</div>
                <div class="stat-label">Classification systems</div>
            </div>
            <div class="stat">
                <div class="stat-value">7,000+</div>
                <div class="stat-label">Hierarchical codes</div>
            </div>
            <div class="stat">
                <div class="stat-value">85+</div>
                <div class="stat-label">Domain categories</div>
            </div>
        </div>

        <div class="feature-grid">
            <div class="feature-card">
                <div class="tag">Live</div>
                <h3>Classification Systems</h3>
                <p>Discrete value sets with defined relationships. Wire gauges, IP ratings, shoe sizes, thread standards, battery types, and hundreds more. Query values, convert between related systems.</p>
            </div>
            <div class="feature-card">
                <div class="tag">Live</div>
                <h3>Measurement Conversions</h3>
                <p>Continuous scales with formula-based conversion. Temperature, pressure, length, mass, volume. Convert any value between related units with verified formulas.</p>
            </div>
            <div class="feature-card">
                <div class="tag">Live</div>
                <h3>Encoding Systems</h3>
                <p>Hierarchical code structures with parent-child relationships. HS codes for international trade, with ICD-10, NAICS, and other standard taxonomies in development.</p>
            </div>
            <div class="feature-card">
                <div class="tag">Coming soon</div>
                <h3>Real-World Catalogs</h3>
                <p>Registries of physical things. Ships by hull number, aircraft by registration, products by UPC. Including real-time observations where available — tide levels, positions, status.</p>
            </div>
        </div>
    </section>

    <section>
        <h2>Connect your AI assistant</h2>
        <p>Ground uses the Model Context Protocol (MCP) to integrate directly with AI assistants. Your assistant queries Ground for facts instead of guessing. <a href="https://registry.modelcontextprotocol.io/servers/fyi.ground%2Fground">View on MCP Registry</a></p>

        <div class="tabs">
            <div class="tab-buttons">
                <button class="tab-btn active" data-tab="claude-web">Claude (Web)</button>
                <button class="tab-btn" data-tab="claude-desktop">Claude Desktop</button>
                <button class="tab-btn" data-tab="chatgpt">ChatGPT</button>
                <button class="tab-btn" data-tab="other">Other clients</button>
            </div>

            <div id="claude-web" class="tab-content active">
                <h4>Server URL</h4>
                <div class="url-box"><code>https://mcp.ground.fyi/mcp</code><button class="copy-btn" data-url="https://mcp.ground.fyi/mcp">Copy</button></div>

                <h4>Setup steps</h4>
                <ol>
                    <li>Open <a href="https://claude.ai">claude.ai</a> and go to <strong>Settings</strong></li>
                    <li>Select <strong>Connectors</strong> in the sidebar</li>
                    <li>Click <strong>Add custom connector</strong> at the bottom</li>
                    <li>Paste the server URL above and click <strong>Add</strong></li>
                    <li>Click <strong>Connect</strong> and complete the signup flow to create your Ground account</li>
                    <li>Click <strong>Allow</strong> to grant Claude access</li>
                </ol>

                <p>Once connected, enable Ground via the <strong>+</strong> button in your chat and select it from Connectors.</p>

                <div class="plan-note">Available on Claude Pro, Max, Team, and Enterprise plans.</div>
            </div>

            <div id="claude-desktop" class="tab-content">
                <h4>Server URL</h4>
                <div class="url-box"><code>https://mcp.ground.fyi/mcp</code><button class="copy-btn" data-url="https://mcp.ground.fyi/mcp">Copy</button></div>

                <h4>Setup steps</h4>
                <ol>
                    <li>Open Claude Desktop and go to <strong>Settings</strong></li>
                    <li>Select <strong>Connectors</strong> in the sidebar</li>
                    <li>Click <strong>Add custom connector</strong></li>
                    <li>Paste the server URL above and click <strong>Add</strong></li>
                    <li>Click <strong>Connect</strong> and complete the signup flow to create your Ground account</li>
                    <li>Click <strong>Allow</strong> to grant Claude access</li>
                </ol>

                <p>Once connected, Ground tools are automatically available in all conversations.</p>

                <div class="plan-note">Available on Claude Pro, Max, Team, and Enterprise plans.</div>
            </div>

            <div id="chatgpt" class="tab-content">
                <h4>Server URL</h4>
                <div class="url-box"><code>https://mcp.ground.fyi/mcp</code><button class="copy-btn" data-url="https://mcp.ground.fyi/mcp">Copy</button></div>

                <h4>Setup steps</h4>
                <ol>
                    <li>Go to <strong>Settings → Apps & Connectors</strong></li>
                    <li>Under Advanced settings, enable <strong>Developer Mode</strong></li>
                    <li>Click <strong>Create</strong> to add a new connector</li>
                    <li>Enter a name (e.g., "Ground") and paste the server URL above</li>
                    <li>Complete the signup flow to create your Ground account</li>
                    <li>Authorize access when prompted</li>
                </ol>

                <p>To use Ground in a chat, click the <strong>+</strong> button, select <strong>More</strong>, and choose your connector.</p>

                <div class="plan-note">Available on ChatGPT Pro, Plus, Team, Enterprise, and Edu plans. Requires Developer Mode.</div>
            </div>

            <div id="other" class="tab-content">
                <h4>Server URL</h4>
                <div class="url-box"><code>https://mcp.ground.fyi/mcp</code><button class="copy-btn" data-url="https://mcp.ground.fyi/mcp">Copy</button></div>

                <h4>Connection details</h4>
                <p style="color: var(- -color-text-secondary); margin-bottom: 1rem;">Any MCP-compatible client can connect using:</p>
                <ul style="color: var(- -color-text-secondary); margin-left: 1.25rem;">
                    <li><strong>Transport:</strong> Streamable HTTP</li>
                    <li><strong>Authentication:</strong> OAuth 2.0 with PKCE</li>
                    <li><strong>OAuth metadata:</strong> <code>/.well-known/oauth-authorization-server</code></li>
                    <li><strong>Scopes:</strong> <code>catalog:read</code>, <code>catalog:write</code></li>
                </ul>

                <div class="plan-note">Gemini web app does not yet support custom MCP servers. Gemini CLI users can configure the server manually.</div>
            </div>
        </div>

        <div class="example-box">
            <div class="label">Example query</div>
            <code>"What's the metric equivalent of 12 AWG wire?"</code>
        </div>
    </section>

    <section>
        <h2>REST API</h2>
        <p>For developers building applications, Ground provides a straightforward REST API with OpenAPI documentation.</p>

        <div class="feature-grid">
            <div class="feature-card">
                <h3>Query domains</h3>
                <p>Search and filter across all reference data domains. Full-text search, semantic search, and structured filtering by category, type, and status.</p>
            </div>
            <div class="feature-card">
                <h3>Look up values</h3>
                <p>Get detailed information about specific codes and values. Metadata, relationships, equivalent values in other systems.</p>
            </div>
            <div class="feature-card">
                <h3>Convert between systems</h3>
                <p>Convert values between related systems using verified formulas and equivalence mappings. Works for both continuous measurements and discrete classifications.</p>
            </div>
            <div class="feature-card">
                <h3>Navigate hierarchies</h3>
                <p>Traverse parent-child relationships in encoding systems. Get ancestors, descendants, or siblings of any code.</p>
            </div>
        </div>
    </section>

    <section>
        <h2>Coming soon</h2>
        <p>Ground is expanding to cover more of the structured data that AI needs to be reliable.</p>

        <div class="feature-grid">
            <div class="feature-card">
                <h3>Browsable database</h3>
                <p>A public website for exploring Ground's data directly. Browse domains, search values, understand relationships — similar to how you might browse Wikipedia.</p>
            </div>
            <div class="feature-card">
                <h3>Real-time observations</h3>
                <p>Live data attached to catalog entries. Current tide levels at NOAA stations, aircraft positions, weather observations. Historical data for trend analysis.</p>
            </div>
            <div class="feature-card">
                <h3>Cross-system mappings</h3>
                <p>Equivalences and crosswalks between related systems. ICD-9 to ICD-10 mappings, NAICS to SIC codes, and other standard translations.</p>
            </div>
            <div class="feature-card">
                <h3>Expanded catalogs</h3>
                <p>More registries of real-world entities. FAA aircraft registry, maritime vessel databases, product identifiers, geographic codes.</p>
            </div>
        </div>
    </section>

    <section>
        <h2>Pricing</h2>
        <p>Simple, flat-rate pricing. No per-request fees, no usage tiers.</p>

        <div class="pricing-card">
            <div class="price">$3<span>/month</span></div>
            <div class="alt-price">or $30/year</div>
            <ul>
                <li>Full API access</li>
                <li>All classification systems</li>
                <li>All measurement conversions</li>
                <li>All encoding systems</li>
                <li>MCP integration</li>
                <li>10,000 requests/hour</li>
            </ul>
            <a href="https://api.ground.fyi/auth/register" class="btn btn-primary" style="width: 100%; justify-content: center;">Start free trial</a>

            <div class="pricing-note">
                <strong>Early access:</strong> Free access available for users who can provide constructive feedback as we prepare for public launch.
            </div>
        </div>
    </section>
</main>

<footer>
    <div class="footer-inner">
        <span class="copyright">&copy; 2025 Ground</span>
        <div class="footer-links">
            <a href="/changelog">Changelog</a>
            <a href="/privacy">Privacy</a>
            <a href="/terms">Terms</a>
            <a href="https://api.ground.fyi/docs">API</a>
        </div>
    </div>
</footer>

<script>
    // Tab switching
    document.querySelectorAll('.tab-btn').forEach(button => {
        button.addEventListener('click', () => {
            const tabId = button.dataset.tab;

            document.querySelectorAll('.tab-btn').forEach(btn => btn.classList.remove('active'));
            document.querySelectorAll('.tab-content').forEach(content => content.classList.remove('active'));

            button.classList.add('active');
            document.getElementById(tabId).classList.add('active');
        });
    });

    // Copy URL to clipboard
    document.querySelectorAll('.copy-btn').forEach(button => {
        button.addEventListener('click', async () => {
            const url = button.dataset.url;
            await navigator.clipboard.writeText(url);

            button.textContent = 'Copied!';
            button.classList.add('copied');

            setTimeout(() => {
                button.textContent = 'Copy';
                button.classList.remove('copied');
            }, 2000);
        });
    });
</script>