Philosopher's Stone

Developer Documentation

Integrate the Philosopher's Stone knowledge base into your applications

Contents

API Endpoints

All endpoints are public. No authentication required. Responses are JSON with a data key.

GET /api/v1/knowledge

Search and list published knowledge chunks.

Query Parameters:

  • q - Search query (full-text search with stemming)
  • topic - Filter by topic slug
  • limit - Max results (default: 20)
  • offset - Pagination offset (default: 0)
curl "https://philosophersstone.ee/api/v1/knowledge?q=alchemy&limit=10"
GET /api/v1/topics

Get the full topic tree with nested children.

curl "https://philosophersstone.ee/api/v1/topics"
GET /api/v1/submit

Submit knowledge to the commons. No authentication required.

Query Parameters:

  • content - The knowledge content (required, min 20 chars)
  • title - Optional title
  • topic - Optional suggested topic slug
curl "https://philosophersstone.ee/api/v1/submit?content=Your+knowledge+here"
GET /api/v1/openapi.json

OpenAPI 3.0 specification. Use for importing into Postman or setting up ChatGPT Actions.

MCP Integration (Claude)

The Philosopher's Stone includes a built-in Model Context Protocol (MCP) server, allowing Claude and other MCP-compatible AI assistants to directly query the knowledge base.

Remote MCP Endpoint

Connect any MCP client to our remote server — no local setup required:

POST https://philosophersstone.ee/mcp

For Claude Desktop, add this to your claude_desktop_config.json: 

{
  "mcpServers": {
    "philosophers-stone": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://philosophersstone.ee/mcp"]
    }
  }
}

Available MCP Tools

  • search_knowledge - Search the knowledge base by query and optional topic
  • list_topics - Browse the topic hierarchy
  • get_topic - Get a topic with its knowledge chunks
  • submit_knowledge - Submit new knowledge to the commons

ChatGPT Actions

Integrate the Philosopher's Stone as a ChatGPT Action using the OpenAPI specification.

Setup Steps

  1. Go to your GPT's configuration in ChatGPT
  2. Click "Create new action"
  3. Import the schema from: https://philosophersstone.ee/api/v1/openapi.json
  4. Test the actions and publish your GPT