Build on yggy

Read and write your organization’s knowledge graph from code, connect AI clients over MCP, and react to events with webhooks. Everything respects the same members, projects and permissions as the app.

REST API Upload documents, query the graph and read extracted facts with an API key.

MCP Give Claude, Cursor or VS Code access to your graph. Members sign in, no keys to share.

Webhooks Get a signed request when a document is processed, a review item opens or a sync fails.

SDKs and CLI Typed clients for TypeScript, Python, Go and Rust, and a command line for scripts and CI.

Quickstart

In yggy, open Developers → API keys and create a personal key with graph:read, which a query needs.
Export it as YGGY_API_KEY and run a query. Replace acme-corp with your organization slug or id:

curl --fail-with-body "https://api.yggy.tech/api/v1/query" \
  --header "Authorization: Bearer $YGGY_API_KEY" \
  --header "x-yggy-organization-id: acme-corp" \
  --header "content-type: application/json" \
  --data '{"question":"Which contracts renew in Q1?"}'

const res = await fetch("https://api.yggy.tech/api/v1/query", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.YGGY_API_KEY}`,
    "x-yggy-organization-id": "acme-corp",
    "content-type": "application/json",
  },
  body: JSON.stringify({"question":"Which contracts renew in Q1?"}),
});
console.log(await res.json());

import os
import requests

res = requests.post(
    "https://api.yggy.tech/api/v1/query",
    headers={
        "Authorization": f"Bearer {os.environ['YGGY_API_KEY']}",
        "x-yggy-organization-id": "acme-corp",
    },
    json={"question":"Which contracts renew in Q1?"},
)
print(res.json())

Developers → Usage and logs in yggy shows each request as it arrives, so you can see a 401 or 429 without digging through logs. See Errors and rate limits, or follow the Quickstart step by step.

Choose how to authenticate

Method	Acts as	Use it for
Personal key	You, with your project access	Scripts, notebooks, local tools
Organization key	The admin who creates it, with the permissions they pick	Pipelines and services the whole organization relies on
MCP sign-in	The member who signs in	AI clients such as Claude Code, Cursor and VS Code

Authentication covers permissions, the IP allowlist and the actions that need a signed-in person.

Build on yggy

Quickstart

Choose how to authenticate

Next steps