SDKs

The SDKs are for teams writing code. If you're using Claude Desktop, Cursor, Windsurf, n8n, or any other agent framework, you probably want the MCP integration instead — it works without writing any code.

PostGrad offers official SDKs for two languages:

• TypeScript SDK — for Node.js, Deno, and browser environments
• Python SDK — for Python 3.9+ applications and AI frameworks

Both SDKs provide typed interfaces, automatic retry on rate limits, built-in error handling, and a defaultFeed option so you do not have to pass the feed header on every call. They wrap the REST API so you do not need to manage HTTP requests directly.

Install

# TypeScript / JavaScript
npm install postgrad

# Python
pip install postgrad

Quick example

import { PostGrad } from 'postgrad'

const pg = new PostGrad({
  apiKey: process.env.POSTGRAD_API_KEY,
  defaultFeed: '00000000-0000-0000-0000-000000000000',
})

const results = await pg.knowledge.search({ q: 'pricing strategy' })

from postgrad import PostGrad

client = PostGrad(
    api_key=os.environ["POSTGRAD_API_KEY"],
    default_feed="00000000-0000-0000-0000-000000000000",
)

results = client.knowledge.search(q="pricing strategy")

If you prefer to make HTTP requests directly, see the REST API reference or the Bot Quickstart for a curl walkthrough.