# SDKs and MCP server for the Novig data API

> Independent. Not affiliated with, endorsed by or sponsored by Novig.

Canonical: https://novigapi.com/sdks
Facts checked: 2026-11-15

novigapi.com has a Python client on PyPI (`pip install novigapi`, version 0.1.0 on 15 Nov 2026), a TypeScript client and a stdio MCP server, all open source in the novigapi GitHub organization. Each wraps the same REST API at https://novigapi.com/api/v1 with one nv_ key and needs no Novig account. (Source: [PyPI: novigapi](https://pypi.org/project/novigapi/))

The packages are thin: every method maps to one REST endpoint and returns the same `{ data, meta }` envelope, so the [endpoint reference](https://novigapi.com/docs/endpoints) documents them too. They are maintained by the operator of novigapi.com in the [novigapi GitHub organization](https://github.com/novigapi), MIT licensed. Novig does not publish or endorse them.

Client packages, checked 2026-11-15

| Package | For | Install | Source |
| --- | --- | --- | --- |
| [novigapi on PyPI](https://pypi.org/project/novigapi/) | Python 3.8+, standard library only | `pip install novigapi` | [novigapi-python](https://github.com/novigapi/novigapi-python) |
| novigapi (TypeScript) | Node 18+, Deno, Bun; no runtime deps | Not on npm yet; build from the repo | [novigapi-js](https://github.com/novigapi/novigapi-js) |
| novigapi-mcp (stdio MCP) | Claude Desktop, Cursor, any stdio MCP client | Not on npm yet; use the remote URL | [novigapi-mcp](https://github.com/novigapi/novigapi-mcp) |


## Python

Standard library only (`urllib`, `json`), Python 3.8 or later. Install it from [PyPI](https://pypi.org/project/novigapi/) and put your key in `NOVIGAPI_KEY`:

```bash
pip install novigapi
export NOVIGAPI_KEY=nv_...
```

```python
from novigapi import NovigAPI, devig

api = NovigAPI()  # reads NOVIGAPI_KEY

page = api.markets(league="NFL", status="open", limit=20)
for m in page["data"]:
    o = m["outcomes"][0]
    print(m["description"], o["bid"], o["ask"], o["fair"])

print(devig([0.5238, 0.5238], "shin"))  # [0.5, 0.5]
```

`api.iter_rows("markets", league="NBA")` follows `meta.next_cursor` for you. The [Python guide](https://novigapi.com/novig-api-python) covers pandas and the raw requests version.

## JavaScript and TypeScript

ESM with types, on the global `fetch`, so it runs on Node 18+, Deno, Bun and edge functions. It is not on npm yet: clone [novigapi-js](https://github.com/novigapi/novigapi-js), run `npm install && npm run build`, then install the folder. Plain `fetch` works too; the [JavaScript guide](https://novigapi.com/novig-api-javascript) shows it.

```bash
git clone https://github.com/novigapi/novigapi-js.git
cd novigapi-js && npm install && npm run build
cd ../your-app && npm install ../novigapi-js
```

```typescript
import { NovigAPI, devig } from "novigapi";

const api = new NovigAPI(); // reads NOVIGAPI_KEY

const page = await api.markets({ league: "NBA", status: "open", limit: 20 });
for (const m of page.data) console.log(m.description, m.outcomes[0].fair);

console.log(devig([0.5238, 0.5238], "shin")); // [0.5, 0.5]
```

Keep the key on a server. A browser bundle would show it to every visitor.

## MCP server

Clients that speak remote MCP can use https://novigapi.com/api/mcp directly; see [Use with Claude](https://novigapi.com/use-with-claude) and [Use with Cursor](https://novigapi.com/use-with-cursor). For clients that only start local processes, [novigapi-mcp](https://github.com/novigapi/novigapi-mcp) is a zero-dependency stdio bridge (Node 18+) that forwards each JSON-RPC message to that URL. `search`, `fetch` and `devig` work without a key.

> novigapi-mcp is not on npm yet, so `npx novigapi-mcp` does not resolve. Until it does, run it from a clone (`node bin/novigapi-mcp.mjs`, see the [repo](https://github.com/novigapi/novigapi-mcp)) or use the remote URL.

## Which one to use

- **Scripts, notebooks, backtests:** the Python client, or plain `requests`.
- **A Node service or edge function:** the TypeScript client, or plain `fetch`.
- **Claude, Cursor or another agent:** the remote MCP URL; the stdio package only for clients without remote support.
- **Anything else:** the REST API and [openapi.json](https://novigapi.com/openapi.json); every language with HTTP works.

## Questions

### Is there a Python package for Novig data?

Yes: `pip install novigapi` installs novigapi.com's read-only client from PyPI (0.1.0 on 15 Nov 2026). It reads market data; it cannot place Novig orders.

### Is there an npm package?

Not yet. The TypeScript client and the stdio MCP server are on GitHub (https://github.com/novigapi/novigapi-js, https://github.com/novigapi/novigapi-mcp); until they reach npm, use fetch or the remote MCP URL.

### Are these Novig's official SDKs?

No. They are clients for novigapi.com, an independent read-only data API. Novig's own trading API is documented at docs.novig.com and needs a Novig account.

### Do I need a key?

For market data, yes: a free nv_ key from /sign-up. The MCP tools search, fetch and devig work without one.

## Sources

- [PyPI: novigapi](https://pypi.org/project/novigapi/)
- [GitHub: the novigapi organization](https://github.com/novigapi)
- [GitHub: novigapi/novigapi-python](https://github.com/novigapi/novigapi-python)
- [GitHub: novigapi/novigapi-js](https://github.com/novigapi/novigapi-js)
- [GitHub: novigapi/novigapi-mcp](https://github.com/novigapi/novigapi-mcp)

---

Get a free API key: https://novigapi.com/sign-up . Docs: https://novigapi.com/docs . MCP: https://novigapi.com/api/mcp . Operated by Stunning Couches LLC. Independent. Not affiliated with, endorsed by or sponsored by Novig.
