A profound philosophical harness for frontier models
Thiruvalluvar, weaver of the Thirukkural, in a halftone engraving
Download

Every answer, through the Kural

One thousand three hundred and thirty couplets, checked letter by letter.

The demo

One question. Three AIs.
One Kural.

“My friend lied to me” — answered through Thirukkural 294, in each app’s own voice. Every quoted word is checked letter by letter.

Connect

Add it to your AI

A real screen recording: Valluvakural being added as a custom MCP server inside ChatGPT, then answering a question with a checked verse.

A real screen recording · no mock-ups, no voice-over

The lens

Every verse, letter-checked.

The model gets its verses from the book. We match each one against the original before it is allowed through. If it doesn't match, it doesn't go out.

  • 1,330couplets in the book
  • 2tools — both only read
  • 0made-up verses let through

Every chapter is included · In a crisis, real help comes first

What the lens can read
Aram virtue380
Porul wealth700
Inbam love250
Couplets in the corpus1,330

Nothing sampled, nothing trimmed, nothing rewritten. The verse the model quotes is the verse in the book.

The numbers

Measured, not claimed.

We asked the server a hundred real questions — worry, grief, love, work, money, meaning — and read every answer. Three numbers worth your time.

90%
the right verse, first time
Within the first three, 97%. Within the first ten, 98%.
0.0%
made-up verses
Out of 1,000 couplets returned, none was invented. The quote gate rejects the fake ones.
49.3
reading ease of the old English
This one is ours to fix. The 19th-century translations are hard going; new wording is being written.

100 questions, run against the live server on 3 October 2026. The script is in the repo — run it yourself.

The running count lives on its own page: stats.html.

Connect

Works with ChatGPT, Claude and Gemini.

Add the connector, then paste one line into your assistant’s own instructions. After that the Kural turns up by itself — even when you only say what happened.

Claude.ai web
Settings → Connectors → Add custom connector → valluvakural.com/mcp
ChatGPT web
Settings → Apps → Advanced → Developer mode → valluvakural.com/mcp
Gemini Gem
Drop in kural-corpus.json and paste the prompt into your Gem.
Then this one line, in your assistant’s instructions

Some assistants wait to be asked before they use a connector. This line tells them not to.

custom instructions
If I share a personal situation, an emotion, a dilemma, or ask for guidance, use the Valluvakural connector before you answer: call kural_guidance, open with the couplet's meaning in plain words, and cite the kural number. Do this even when I say something as short as "my parents lied to me" or "I feel lost" - do not wait for me to ask for the Thirukkural.
Check it yourself — eight questions to try cold

Open a new chat in a fresh account and send these, one at a time. The Kural should answer in the first reply.

  1. my parents lied to me
  2. my friend betrayed me
  3. I feel completely lost
  4. I am angry with my brother
  5. Should I forgive someone who hurt me?
  6. என் பெற்றோர் என்னிடம் பொய் சொன்னார்கள்
  7. I failed my examination
  8. I am worried about my future
Claude Desktop, Cursor, Windsurf — the file

Grab kural-mcp.cjs, then copy the config below and point it at the file.

any MCP client
{
  "mcpServers": {
    "kural-thirukkural": {
      "command": "node",
      "args": ["/absolute/path/to/kural-mcp.cjs"]
    }
  }
}
Claude skill — for people who want it always on

A skill’s description stays in Claude’s context, so it fires even when the connector sits in a deferred list. Save this as SKILL.md inside a skill folder and add it to Claude.

SKILL.md
---
name: valluvakural
description: Use whenever the user shares a personal situation, emotion, dilemma, family conflict, betrayal, grief, worry, anger or uncertainty, or asks for guidance - even if they never mention the Thirukkural. Consult the Valluvakural connector first.
---

# Valluvakural

1. Call kural_guidance on the Valluvakural connector with the user's situation in their own language - before you answer.
2. Open with the couplet's meaning in plain words (most people cannot read Tamil), then weave it into your own voice.
3. Cite it as (Thirukkural, ch. N, kural N).
4. Never invent a verse: quote only what the tool returned; run verify_quote before presenting any quotation.
5. In a crisis, surface real help first (India: Tele-MANAS 14416).
Join in

We are opening three channels.

A verse most days, a short reading each week, and a room to ask questions. Nothing is sold here — the book is free, and so is everything we make with it.

X threads
One verse and one idea a day. Threads, not announcements.
YouTube readings
A short reading each week, in Tamil and in English.
Discord the room
Ask anything about the verses, the code, or the site.

The handles go up here as soon as the channels are open. If you would rather hear from us by email: valluvakuralsupport@gmail.com