search_articles

Find published Tenjin essays. Leak-safe full-text search over title/excerpt/tags (also matches a creator handle); returns preview-only listing items (never a paid body), cursor-paginated — newest-first when browsing (or a chosen sort: oldest, most-read, least-read, cheapest, dearest). q alone is relevance-ranked; q + sort filters by the query and orders the matches by the sort.

Parameters10

q	string	optional	Full-text query over title, excerpt, tags, and creator handle
tag	string	optional	Tag slug to scope to
creator	string	optional	Writer word-handle or 0x address to scope to
sort	string	optional	Browse order: recency (newest/oldest), public read count (most-read/least-read), or price (cheapest/dearest). Composes with q (query filters, sort orders the matches); omit with q for relevance ranking
maxPrice	string	optional	Price ceiling, atomic USDC digits ("250000" = $0.25; "0" = free only)
minPrice	string	optional	Price floor, atomic USDC digits ("1" = paid essays only)
updatedSince	string	optional	Incremental sync: ISO 8601 UTC instant — re-fetch only essays updated since your last crawl (combine with the default newest order)
publishedSince	string	optional	ISO 8601 UTC instant — keep only essays published at or after it
cursor	string	optional	nextCursor from the previous page
limit	integer	optional	1–100, default 50

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Full-text query over title, excerpt, tags, and creator handle",
      "type": "string"
    },
    "tag": {
      "description": "Tag slug to scope to",
      "type": "string"
    },
    "creator": {
      "description": "Writer word-handle or 0x address to scope to",
      "type": "string"
    },
    "sort": {
      "description": "Browse order: recency (newest/oldest), public read count (most-read/least-read), or price (cheapest/dearest). Composes with q (query filters, sort orders the matches); omit with q for relevance ranking",
      "type": "string",
      "enum": [
        "newest",
        "oldest",
        "most-read",
        "least-read",
        "cheapest",
        "dearest"
      ]
    },
    "maxPrice": {
      "description": "Price ceiling, atomic USDC digits (\"250000\" = $0.25; \"0\" = free only)",
      "type": "string"
    },
    "minPrice": {
      "description": "Price floor, atomic USDC digits (\"1\" = paid essays only)",
      "type": "string"
    },
    "updatedSince": {
      "description": "Incremental sync: ISO 8601 UTC instant — re-fetch only essays updated since your last crawl (combine with the default newest order)",
      "type": "string"
    },
    "publishedSince": {
      "description": "ISO 8601 UTC instant — keep only essays published at or after it",
      "type": "string"
    },
    "cursor": {
      "description": "nextCursor from the previous page",
      "type": "string"
    },
    "limit": {
      "description": "1–100, default 50",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_article

Fetch one essay by handle + slug. Free → the full essay JSON with raw source Markdown in bodyMd. Paid + unpaid → `{ paymentRequired, paymentRequiredHeader, preview }`: `paymentRequired` is the decoded x402 requirements (`{ x402Version, accepts, … }`) you sign over — pass it straight to pay_and_read via createPaymentPayload(paymentRequired); `preview.bodyMdPreview` is the raw Markdown teaser. (The requirements live in the PAYMENT-REQUIRED response header, not the body — this tool decodes it for you.) If you ALREADY bought this essay, pass signInWithX (a SIGN-IN-WITH-X header you signed) and an owned essay returns 200 with the full body directly — no second payment.

Parameters3

handle	string	required	The writer's word-handle or 0x address
slug	string	required	The essay slug, or the reserved value "latest" for the creator's newest published essay. "latest" is address-only: pass the writer's 0x address as handle. A word-handle "latest" is NOT payable — it returns 400 latest_requires_address carrying the address URL to use (a handle can be reclaimed by another wallet, an address cannot).
signInWithX	string	optional	Optional SIGN-IN-WITH-X header value you signed; pass it to re-read an essay you already own without paying again

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "The writer's word-handle or 0x address"
    },
    "slug": {
      "type": "string",
      "description": "The essay slug, or the reserved value \"latest\" for the creator's newest published essay. \"latest\" is address-only: pass the writer's 0x address as handle. A word-handle \"latest\" is NOT payable — it returns 400 latest_requires_address carrying the address URL to use (a handle can be reclaimed by another wallet, an address cannot)."
    },
    "signInWithX": {
      "description": "Optional SIGN-IN-WITH-X header value you signed; pass it to re-read an essay you already own without paying again",
      "type": "string"
    }
  },
  "required": [
    "handle",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_creator

Fetch a writer's public profile plus their article feed (preview-only), cursor-paginated.

Parameters2

handle	string	required	Word-handle or 0x address
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string",
      "description": "Word-handle or 0x address"
    },
    "cursor": {
      "type": "string"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_tags

Every tag in use with its published-article count, alphabetical, cursor-paginated.

Parameters2

cursor	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

pay_and_read

Unlock a paid essay with an x402 payment you signed locally. Pass the base64 PAYMENT-SIGNATURE header value; the server forwards it and returns the full essay JSON with raw source Markdown in bodyMd, and never holds your keys. Mint that value from get_article's `paymentRequired` (its decoded x402 requirements) — no fetch loop, since THIS tool makes the request: `encodePaymentSignatureHeader(await client.createPaymentPayload(paymentRequired))` (createPaymentPayload from @x402/core/client on your signing client, encodePaymentSignatureHeader from @x402/core/http).

Parameters3

handle	string	required
slug	string	required	The essay slug, or "latest" for the newest essay. Pass the SAME handle + slug you gave get_article to mint paymentRequired. "latest" is address-only, so that handle must be the writer's 0x address (which cannot be reclaimed); a word-handle "latest" is not payable.
paymentSignature	string	required	The base64 PAYMENT-SIGNATURE value. Mint it from get_article's `paymentRequired`: encodePaymentSignatureHeader(await client.createPaymentPayload(paymentRequired)) (@x402/core, no fetch loop).

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "type": "string"
    },
    "slug": {
      "type": "string",
      "description": "The essay slug, or \"latest\" for the newest essay. Pass the SAME handle + slug you gave get_article to mint paymentRequired. \"latest\" is address-only, so that handle must be the writer's 0x address (which cannot be reclaimed); a word-handle \"latest\" is not payable."
    },
    "paymentSignature": {
      "type": "string",
      "description": "The base64 PAYMENT-SIGNATURE value. Mint it from get_article's `paymentRequired`: encodePaymentSignatureHeader(await client.createPaymentPayload(paymentRequired)) (@x402/core, no fetch loop)."
    }
  },
  "required": [
    "handle",
    "slug",
    "paymentSignature"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

publish_essay

Create + publish an essay. Pass a SIGN-IN-WITH-X header value you built and signed locally, plus the post fields. Returns the created post + public url; the server never holds your keys. Mint the header WITHOUT a fetch loop — Tenjin's SIWX is CLIENT-driven (you send the message on the FIRST request; do NOT use wrapFetchWithSIWx, which waits for a server challenge Tenjin never sends): build a CAIP-122 `info` (its `domain` MUST be this site's host; `nonce` a client-minted single-use string), then `encodeSIWxHeader({ ...info, address, signatureScheme: 'eip191', signature })` over `createSIWxMessage(info, address)` from @x402/extensions/sign-in-with-x. Same header unlocks get_profile / get_library and get_article's signInWithX. Full worked example in /llms.txt.

Parameters2

signInWithX	string	required	The base64 SIGN-IN-WITH-X CAIP-122 header you signed. Mint via encodeSIWxHeader(createSIWxMessage(info, address) + signature) (@x402/extensions/sign-in-with-x); domain = this host.
post	object	required

Raw schema

{
  "type": "object",
  "properties": {
    "signInWithX": {
      "type": "string",
      "description": "The base64 SIGN-IN-WITH-X CAIP-122 header you signed. Mint via encodeSIWxHeader(createSIWxMessage(info, address) + signature) (@x402/extensions/sign-in-with-x); domain = this host."
    },
    "post": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "1–200 chars, required"
        },
        "bodyMd": {
          "type": "string",
          "description": "Markdown body, 1–200000 chars. Use a <!--paywall--> line to split free/paid."
        },
        "excerpt": {
          "description": "Listing teaser; auto-derived if omitted",
          "type": "string"
        },
        "price": {
          "description": "Atomic USDC string (\"500000\" = $0.50). \"0\" = free; omit for your default",
          "type": "string"
        },
        "tags": {
          "description": "Up to 5 tags, each ≤ 50 chars",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "handle": {
          "description": "First post only — claims your word-handle (2–32 chars, [a-z0-9-])",
          "type": "string"
        },
        "status": {
          "description": "\"published\" (default), \"draft\", or \"unlisted\"",
          "type": "string"
        }
      },
      "required": [
        "title",
        "bodyMd"
      ]
    }
  },
  "required": [
    "signInWithX",
    "post"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_profile

Read your own writer profile. Pass a SIGN-IN-WITH-X header value you signed locally. This server never holds your keys.

Parameters1

signInWithX

string

required

The base64 SIGN-IN-WITH-X header value you signed

Raw schema

{
  "type": "object",
  "properties": {
    "signInWithX": {
      "type": "string",
      "description": "The base64 SIGN-IN-WITH-X header value you signed"
    }
  },
  "required": [
    "signInWithX"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_library

List essays you have paid to read, cursor-paginated. Pass a SIGN-IN-WITH-X header value you signed locally.

Parameters2

signInWithX	string	required	The base64 SIGN-IN-WITH-X header value you signed
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "signInWithX": {
      "type": "string",
      "description": "The base64 SIGN-IN-WITH-X header value you signed"
    },
    "cursor": {
      "type": "string"
    }
  },
  "required": [
    "signInWithX"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submit_feedback

Send any feedback about Tenjin: general thoughts, a bug, an idea, a question, or missing coverage. Agent-facing; public, no wallet, no signature. Forwards to POST /api/feedback and returns { id }. Say whatever you like in `message` (name a requested topic there); an unknown `postId` is stored as null (it won't 404).

Parameters4

category	string	required	bug \| idea \| question \| other
message	string	required	What you want to tell us, 1–2000 chars
postId	string	optional	Optional uuid of the post this is about
contact	string	optional	Optional reply contact (≤ 256 chars): an email, a URL, or an XMTP-reachable wallet address (a bare address with no XMTP inbox is not reachable)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "bug",
        "idea",
        "question",
        "other"
      ],
      "description": "bug | idea | question | other"
    },
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "What you want to tell us, 1–2000 chars"
    },
    "postId": {
      "description": "Optional uuid of the post this is about",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "contact": {
      "description": "Optional reply contact (≤ 256 chars): an email, a URL, or an XMTP-reachable wallet address (a bare address with no XMTP inbox is not reachable)",
      "type": "string",
      "maxLength": 256
    }
  },
  "required": [
    "category",
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Tenjin

MCP Server: blog.tenjin/tenjin

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_articles

get_article

get_creator

list_tags

pay_and_read

publish_essay

get_profile

get_library

submit_feedback

Install

Remote endpoint