# Patent URL: https://docs.hanzo.ai/docs/openapi/patent > The record of who thought of what, and when the machine was asked to write it. Also for this capability: **API** · [CLI](https://docs.hanzo.ai/docs/cli/patent) · [MCP](https://docs.hanzo.ai/docs/mcp-tools/patent) · [SDKs](https://docs.hanzo.ai/docs/sdks) The record of who thought of what, and when the machine was asked to write it. > [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | -------------- | -------------------------------------- | | **Base URL** | `https://api.hanzo.ai` | | **Operations** | 12 | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | ## Specification Specification pending — no HIP in [hanzoai/hips](https://github.com/hanzoai/hips) declares `capability: patent` yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139. ## Four surfaces | Surface | Reaches this capability as | Coverage | | -------- | ---------------------------------------------- | --------------------------------------------------------------------------------- | | **REST** | `patent` at its own prefix | 12 operations | | **CLI** | `hanzo patent …` | 12 of 12 | | **SDK** | — | no published client declares one yet — regenerating the clients is what adds them | | **MCP** | tool `patent` on `https://api.hanzo.ai/v1/mcp` | 12 operations, 3 under the document's own id — ask `describe` for the rest | ## Quickstart ```bash export HANZO_API_KEY=sk-... # console.hanzo.ai → API keys ``` Then the first call — a read that needs nothing but the key. `GET /v1/patent/ideas`, operation `get_patent_ideas`: **CLI** ```bash hanzo patent ideas get ``` **SDK** **.ts** ```ts import { Configuration, PatentApi } from 'hanzoai'; const api = new PatentApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.getPatentIdeas(); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import PatentApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = PatentApi(client).get_patent_ideas() ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.PatentAPI.GetPatentIdeas(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, patent_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = patent_api::get_patent_ideas(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.PatentApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new PatentApi(client).getPatentIdeas(); ``` The method above is the one at the current release of the document. `hanzoai@8.5.914` (npm) and `hanzoai@8.5.914` (PyPI) were generated from an earlier release, where this operation carried a different id, so it spells the method differently — regenerating the clients is what makes the two agree. [SDKs →](https://docs.hanzo.ai/docs/sdks) **HTTP** ```bash curl https://api.hanzo.ai/v1/patent/ideas \ -H "Authorization: Bearer $HANZO_API_KEY" ``` **MCP** MCP reaches **patent** through the `patent` tool, which names its 12 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them: ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "describe", "arguments": { "op": "list_patent_approvals" } } }' ``` Answers `200` with `object` — ok. ## Endpoints | Endpoint | What it does | | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`GET /v1/patent/approvals`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-approvals) | Returns the decision trail — each person's current word on each disclosure. | | [`POST /v1/patent/approvals`](https://docs.hanzo.ai/docs/openapi/patent/post-patent-approvals) | Appends one person's decision about one disclosure. | | [`GET /v1/patent/disclosures`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-disclosures) | Returns the canonical disclosures, each carrying its current approvals. | | [`POST /v1/patent/disclosures`](https://docs.hanzo.ai/docs/openapi/patent/post-patent-disclosures) | Appends the assembled document and the record ids it rests on. | | [`POST /v1/patent/grants`](https://docs.hanzo.ai/docs/openapi/patent/post-patent-grants) | Makes the decision a recording never implied: whether an idea, implementation or disclosure stays private to its author's project, opens to the org, or goes public. | | [`GET /v1/patent/health`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-health) | Reports what this deployment actually guarantees about the records it keeps, in honest states. | | [`GET /v1/patent/ideas`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-ideas) | Returns the caller org's canonical conception entries, oldest appended first, which is the order the log says they were thought. | | [`POST /v1/patent/ideas`](https://docs.hanzo.ai/docs/openapi/patent/post-patent-ideas) | Appends conception entries. | | [`GET /v1/patent/implementations`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-implementations) | Returns the canonical implementation records with their citations. | | [`POST /v1/patent/implementations`](https://docs.hanzo.ai/docs/openapi/patent/post-patent-implementations) | Appends the machine's half of the record, and the idea citation is the load-bearing field: it is what lets a reader see that the conception came first. | | [`GET /v1/patent/proof`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-proof) | Folds the caller's record set and answers the ordering question over it. | | [`GET /v1/patent/timeline`](https://docs.hanzo.ai/docs/openapi/patent/get-patent-timeline) | Returns every retained version of one entry, in append order. | --- [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)