Feason Context SDKs

Typed, dependency-free TypeScript and Python clients for the Feason Context REST API, plus its OpenAPI 3.1 contract.

Feason Context supplies source-grounded Christian research material with exact passages, provenance, stable citations, named tradition coverage, and explicit coverage boundaries. Applications decide how to use the returned evidence.

Included

• typescript/ — @feason/context

• python/ — feason-context

• openapi/feason-context-openapi.yaml — the public REST contract

• contract.json — versioned endpoint metadata used to generate both clients

• server.json — official MCP Registry metadata for the hosted remote server

• DIRECTORY_LISTING.md — reusable, boundary-aware MCP directory copy

• USE_CASES.md — application recipes, operation selection, and response handling

Both clients expose seven REST operations: manifest, contextualize, claim evaluation, claim proof, search, evidence packets, and citation verification. The TypeScript SDK also composes them through FeasonStudyClient.study and compareTraditions. These helpers preserve retrieved evidence and report verification failures and missing tradition coverage explicitly.

The hosted service remains at https://www.feason.com. These clients do not contain the Feason corpus, production credentials, user data, retrieval engine, or server implementation. Tokens are accepted at runtime and are never persisted.

Related MCP server: biblebridge-mcp

TypeScript

import { FeasonContextClient } from "@feason/context";

const client = new FeasonContextClient({ token: process.env.FEASON_CONTEXT_TOKEN! });
const packet = await client.evidencePacket({ question: "How did early Christians describe grace?" });
console.log(packet);

Python

import os
from feason_context import FeasonContextClient

client = FeasonContextClient(os.environ["FEASON_CONTEXT_TOKEN"])
packet = client.evidence_packet("How did early Christians describe grace?")
print(packet)

Development

node scripts/generate-clients.mjs --check
npm --prefix typescript install
npm --prefix typescript run build
npm --prefix typescript test
python3 -m unittest discover -s python -p 'test_*.py'

Distribution

This checkout tracks SDK source version 0.4.0 and the canonical seven-operation client contract. The OpenAPI document also describes separate Signed Proof V2 routes that these clients do not wrap. No package was published by this update, and registry availability has not been verified. Build or pack the source locally; see PUBLISHING.md for the release preflight and verification sequence.

The hosted MCP service is described separately by server.json. Directory descriptions should preserve Feason's evidence-layer boundaries; see DIRECTORY_LISTING.md.

Security

Do not place API tokens in source, examples, issues, or test fixtures. See SECURITY.md for private vulnerability reporting.

License

MIT. See LICENSE.