Opensource
Open Pulse, MIT licensed. A decision call any AI agent or program can use in any industry, its MCP server and SDK, how to run them, and how to contribute.
Open Pulse (github.com/mypulseapi/open-pulse) is the open-source half of PULSE. PULSE is a decision call: requirements and evidence in, and for every option a verdict out, fits, fails or cannot tell, with what is missing. It works in any industry where options have attributes, products, suppliers, hotels, plans, and it is built for AI agents such as Claude, ChatGPT, Claude Code and Codex as much as for your own code.
The client code is open, so you can read exactly what runs on your machine or your site. The decision engine runs behind the API.
// Which suppliers meet the spec? Any domain: "products" is just the list of options.
await fetch("https://api.thepulseapi.com/api/v1/decide", {
method: "POST",
headers: { "content-type": "application/json", "x-api-key": "pk_live_..." },
body: JSON.stringify({
requirements: [{ attribute: "ip_rating", op: "eq", value: "IP67" }],
products: [
{ id: "acme", attributes: { ip_rating: "IP67" } },
{ id: "corvid", attributes: {} },
],
}),
});
// acme fits · corvid cannot_tell, missing ip_ratingThe repository has runnable examples for developers and agents, an AGENTS.md for coding agents,
and a comparison with typed-decision models such as Jev.
What is released
| Package | What it is | Status | Source |
|---|---|---|---|
@thepulseapi/sdk | The browser SDK: signals, ranking, measurement. About 3 KB on the CDN | On npm, 0.2.0, MIT | mypulseapi/open-pulse |
@thepulseapi/mcp | MCP server: search these docs, and with a key, resolve_products | On npm, 0.2.0, MIT | mypulseapi/open-pulse |
npm install @thepulseapi/sdkFor an agent, add the MCP server to your client (MCP for agents has the config):
npx -y @thepulseapi/mcpWhat is planned
| Planned | What it will do |
|---|---|
| Query parser | Turn a shopper's words into requirements: budget, who it is for, the occasion, in Vietnamese, Thai, Bahasa and English |
| Decision evidence formats | One way to describe buying requirements, product evidence and order outcomes |
| Return-reason taxonomy | Map marketplace return reasons to what went wrong, separating what a listing could have prevented |
No dates: each is released when it is ready, and this page changes the day it is.
What stays behind the API
Ranking and prioritisation, Decision Verification, the Promotion Audit's noise checks and economics, and anything learned from customers' data, which is never published. Open code finds problems; the API decides what is worth fixing.
How to contribute
- Open an issue first on GitHub: a bug, a language the parser misreads, an adapter you need.
- Then a pull request, small and with a test. Contribution terms are being finalised; we will publish them before accepting larger changes.
Licence
MIT. Use, change and ship it in commercial work, keeping the licence notice with the code.
MCP for agents
Connect PULSE to Claude, ChatGPT, Cursor or any MCP client, so an agent searches the documentation instead of guessing, and asks the Decision API which products really meet a shopper's requirements.
Going live
What to check before you ship PULSE, what to watch in the first week, and the claims we will not make for you.