Three Good Sources (3GS) LIVE

API Health View Registry

What is 3GS?

Three Good Sources is a curated trust registry for AI agents. Instead of wading through SEO-gamed search results, agents get exactly three human-vetted, high-quality sources for any topic they need to learn about.

Why exactly three? Because quality beats quantity. Three sources give you enough perspectives to triangulate truth without drowning in noise. Each source is manually researched, ranked, and explained — no spam, no ads, no gaming.

The registry maps natural language queries (how humans actually ask questions) to curated answers, served via the Model Context Protocol (MCP) with cryptographic provenance powered by Pubky.

How to Connect - MCP Clients

Add this to your MCP client configuration:

{
  "mcpServers": {
    "three-good-sources": {
      "url": "https://api.3gs.ai/mcp"
    }
  }
}

The server implements MCP over HTTP POST JSON-RPC. Compatible with any MCP client that supports HTTP transport.

How to Connect - Developers

Test the API with curl:

curl -X POST https://api.3gs.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_sources",
      "arguments": {
        "query": "learn rust"
      }
    }
  }'

This returns three curated sources for learning Rust, including official documentation, tutorials, and practical resources.

Available Tools

get_sources - Find three curated sources for a topic via natural language query
list_categories - List all available topic categories in the registry
get_provenance - Get curator identity and verification information
get_endorsements - Get the list of endorsed curators (future feature)

Live Data

Inspect the API directly:

GET /health - Server status, version, and public key
GET /registry - Full registry JSON with all categories and sources

Vision

3GS is the foundation for a decentralized knowledge graph where curators compete on quality, not SEO tricks. Each registry is cryptographically signed with PKARR keypairs. Curators can endorse each other, building trust networks. Agents can choose which curators to trust based on domain expertise and track records.

The protocol is open. The registry format is documented. Anyone can run a 3GS server, fork the registry, specialize for their domain, or build on top of the trust graph.

Version 1 delivers the core: curated sources, fuzzy query matching, MCP protocol, cryptographic identity, and live API. Future versions will expand federation, endorsements, and cross-registry trust traversal.