Skip to content

Custom HTTP integration ​

If your tool isn't an MCP host, you can still talk to novamem over plain JSON HTTP. Same surface as the MCP tools, just over POST /v1/* with a bearer header.

Authenticate ​

Mint a tenant token from the dashboard (or via POST /v1/me/tokens) and send it as a bearer:

bash
curl -H "Authorization: Bearer nm_..." \
     https://novamem.example.com/health

Remember an entry ​

bash
curl -X POST https://novamem.example.com/v1/remember \
  -H "Authorization: Bearer nm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Decision: Postgres for the main store. MVCC + extensibility.",
    "namespace": "decisions",
    "sourceType": "doc"
  }'

Response:

json
{ "id": "01KQW8EKAJYNTVSGA283SF2ZGQ" }

Search hybrid ​

bash
curl -X POST https://novamem.example.com/v1/search \
  -H "Authorization: Bearer nm_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "why did we pick Postgres",
    "k": 5
  }'

Override weights to force keyword-only or vector-only:

json
{ "query": "ABC123", "weights": { "keyword": 1, "vector": 0, "graph": 0 } }

Walk the graph ​

bash
curl -X POST https://novamem.example.com/v1/neighbors \
  -H "Authorization: Bearer nm_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "01KQW8EKAJYNTVSGA283SF2ZGQ", "depth": 2, "k": 10 }'

SDKs ​

Go — clients/go is the maintained client. A test holds it to route-for-route parity with the server's OpenAPI document, so a new endpoint cannot land without a deliberate decision about the client.

go
import novamem "github.com/azrtydxb/novamem/clients/go"

c, err := novamem.New(novamem.Config{
    BaseURL: "https://novamem.example.com",
    Token:   os.Getenv("NOVAMEM_TOKEN"),
})
saved, err := c.Remember(ctx, novamem.CaptureRequest{
    Content:   "...",
    Namespace: "decisions",
})
hits, err := c.Search(ctx, novamem.SearchRequest{Query: "why did we pick Postgres"})

TypeScript — the @azrtydxb/novamem npm package is deprecated and receives no new endpoints. Call the HTTP API directly, as the curl examples above do; the OpenAPI document describes every route.

See API → Data plane for the full route list.