@reclaimprotocol/agent 0.1.0-dev.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/README.md +287 -0
  2. package/lib/cdp/capture.d.ts +22 -0
  3. package/lib/cdp/capture.js +159 -0
  4. package/lib/cdp/client.d.ts +9 -0
  5. package/lib/cdp/client.js +11 -0
  6. package/lib/cdp/eviction.d.ts +16 -0
  7. package/lib/cdp/eviction.js +38 -0
  8. package/lib/cdp/launcher.d.ts +14 -0
  9. package/lib/cdp/launcher.js +102 -0
  10. package/lib/cdp/tabs.d.ts +6 -0
  11. package/lib/cdp/tabs.js +10 -0
  12. package/lib/cli/args.d.ts +14 -0
  13. package/lib/cli/args.js +19 -0
  14. package/lib/cli/commands.d.ts +1 -0
  15. package/lib/cli/commands.js +19 -0
  16. package/lib/cli.d.ts +1 -0
  17. package/lib/cli.js +7 -0
  18. package/lib/config/store.d.ts +45 -0
  19. package/lib/config/store.js +46 -0
  20. package/lib/index.d.ts +3 -0
  21. package/lib/index.js +7 -0
  22. package/lib/logger.d.ts +2 -0
  23. package/lib/logger.js +7 -0
  24. package/lib/mcp/api/operations.gen.d.ts +152 -0
  25. package/lib/mcp/api/operations.gen.js +2300 -0
  26. package/lib/mcp/api/tools.d.ts +3 -0
  27. package/lib/mcp/api/tools.js +36 -0
  28. package/lib/mcp/remap_errors.d.ts +2 -0
  29. package/lib/mcp/remap_errors.js +27 -0
  30. package/lib/mcp/server.d.ts +38 -0
  31. package/lib/mcp/server.js +76 -0
  32. package/lib/mcp/start.d.ts +1 -0
  33. package/lib/mcp/start.js +63 -0
  34. package/lib/mcp/tools/agent/analyze.d.ts +3 -0
  35. package/lib/mcp/tools/agent/analyze.js +26 -0
  36. package/lib/mcp/tools/agent/attach.d.ts +11 -0
  37. package/lib/mcp/tools/agent/attach.js +72 -0
  38. package/lib/mcp/tools/agent/build.d.ts +33 -0
  39. package/lib/mcp/tools/agent/build.js +74 -0
  40. package/lib/mcp/tools/agent/capture.d.ts +10 -0
  41. package/lib/mcp/tools/agent/capture.js +142 -0
  42. package/lib/mcp/tools/agent/eval.d.ts +5 -0
  43. package/lib/mcp/tools/agent/eval.js +127 -0
  44. package/lib/mcp/tools/agent/find.d.ts +3 -0
  45. package/lib/mcp/tools/agent/find.js +60 -0
  46. package/lib/mcp/tools/agent/proof.d.ts +3 -0
  47. package/lib/mcp/tools/agent/proof.js +214 -0
  48. package/lib/mcp/tools/agent/propose.d.ts +9 -0
  49. package/lib/mcp/tools/agent/propose.js +75 -0
  50. package/lib/mcp/tools/agent/publish.d.ts +3 -0
  51. package/lib/mcp/tools/agent/publish.js +122 -0
  52. package/lib/mcp/tools/agent/replay.d.ts +3 -0
  53. package/lib/mcp/tools/agent/replay.js +46 -0
  54. package/lib/mcp/tools/agent/session.d.ts +10 -0
  55. package/lib/mcp/tools/agent/session.js +29 -0
  56. package/lib/mcp/tools/credentials/authenticate.d.ts +3 -0
  57. package/lib/mcp/tools/credentials/authenticate.js +108 -0
  58. package/lib/mcp/tools/credentials/build.d.ts +16 -0
  59. package/lib/mcp/tools/credentials/build.js +33 -0
  60. package/lib/mcp/tools/credentials/cache.d.ts +70 -0
  61. package/lib/mcp/tools/credentials/cache.js +114 -0
  62. package/lib/mcp/tools/credentials/env-file.d.ts +25 -0
  63. package/lib/mcp/tools/credentials/env-file.js +71 -0
  64. package/lib/mcp/tools/credentials/import.d.ts +2 -0
  65. package/lib/mcp/tools/credentials/import.js +52 -0
  66. package/lib/mcp/tools/credentials/issue.d.ts +2 -0
  67. package/lib/mcp/tools/credentials/issue.js +84 -0
  68. package/lib/mcp/tools/credentials/list-cached.d.ts +2 -0
  69. package/lib/mcp/tools/credentials/list-cached.js +55 -0
  70. package/lib/mcp/tools/credentials/register.d.ts +18 -0
  71. package/lib/mcp/tools/credentials/register.js +30 -0
  72. package/lib/mcp/tools/credentials/resolve-owner-key.d.ts +12 -0
  73. package/lib/mcp/tools/credentials/resolve-owner-key.js +68 -0
  74. package/lib/mcp/tools/credentials/session-cache.d.ts +14 -0
  75. package/lib/mcp/tools/credentials/session-cache.js +19 -0
  76. package/lib/mcp/tools/credentials/status.d.ts +3 -0
  77. package/lib/mcp/tools/credentials/status.js +62 -0
  78. package/lib/mcp-bin.d.ts +1 -0
  79. package/lib/mcp-bin.js +7 -0
  80. package/lib/old/client.d.ts +67 -0
  81. package/lib/old/client.js +146 -0
  82. package/lib/old/flag.d.ts +11 -0
  83. package/lib/old/flag.js +13 -0
  84. package/lib/old/identity.d.ts +22 -0
  85. package/lib/old/identity.js +47 -0
  86. package/lib/old/instructions.d.ts +7 -0
  87. package/lib/old/instructions.js +29 -0
  88. package/lib/old/login-cdp.d.ts +23 -0
  89. package/lib/old/login-cdp.js +125 -0
  90. package/lib/old/to-register.d.ts +47 -0
  91. package/lib/old/to-register.js +133 -0
  92. package/lib/old/tools/authenticate.d.ts +18 -0
  93. package/lib/old/tools/authenticate.js +127 -0
  94. package/lib/old/tools/build.d.ts +9 -0
  95. package/lib/old/tools/build.js +16 -0
  96. package/lib/old/tools/me-providers.d.ts +10 -0
  97. package/lib/old/tools/me-providers.js +32 -0
  98. package/lib/old/tools/publish.d.ts +16 -0
  99. package/lib/old/tools/publish.js +97 -0
  100. package/lib/paths.d.ts +11 -0
  101. package/lib/paths.js +32 -0
  102. package/lib/pkg.d.ts +3 -0
  103. package/lib/pkg.js +13 -0
  104. package/lib/proof/attestor.d.ts +39 -0
  105. package/lib/proof/attestor.js +207 -0
  106. package/lib/proof/replay.d.ts +8 -0
  107. package/lib/proof/replay.js +73 -0
  108. package/lib/provider/constraints.d.ts +2 -0
  109. package/lib/provider/constraints.js +122 -0
  110. package/lib/provider/draft.d.ts +6 -0
  111. package/lib/provider/draft.js +68 -0
  112. package/lib/provider/graphql.d.ts +2 -0
  113. package/lib/provider/graphql.js +35 -0
  114. package/lib/provider/matcher.d.ts +36 -0
  115. package/lib/provider/matcher.js +436 -0
  116. package/lib/provider/normalize.d.ts +4 -0
  117. package/lib/provider/normalize.js +51 -0
  118. package/lib/provider/schema.d.ts +76 -0
  119. package/lib/provider/schema.js +1 -0
  120. package/lib/provider/secrets.d.ts +5 -0
  121. package/lib/provider/secrets.js +22 -0
  122. package/lib/provider/to-version.d.ts +22 -0
  123. package/lib/provider/to-version.js +68 -0
  124. package/lib/types/openapi.d.ts +4 -0
  125. package/lib/types/openapi.js +1 -0
  126. package/package.json +88 -0
  127. package/scripts/download-zk-files.ts +42 -0
  128. package/scripts/prepend-shebang.ts +17 -0
  129. package/skill/SKILL.md +248 -0
  130. package/src/cdp/capture.ts +215 -0
  131. package/src/cdp/client.ts +20 -0
  132. package/src/cdp/eviction.ts +52 -0
  133. package/src/cdp/launcher.ts +133 -0
  134. package/src/cdp/tabs.ts +22 -0
  135. package/src/cli/args.ts +20 -0
  136. package/src/cli/commands.ts +27 -0
  137. package/src/cli.ts +7 -0
  138. package/src/config/store.ts +86 -0
  139. package/src/index.ts +12 -0
  140. package/src/logger.ts +8 -0
  141. package/src/mcp/api/operations.gen.ts +2397 -0
  142. package/src/mcp/api/tools.ts +45 -0
  143. package/src/mcp/remap_errors.ts +35 -0
  144. package/src/mcp/server.ts +119 -0
  145. package/src/mcp/start.ts +78 -0
  146. package/src/mcp/tools/agent/analyze.ts +34 -0
  147. package/src/mcp/tools/agent/attach.ts +95 -0
  148. package/src/mcp/tools/agent/build.ts +99 -0
  149. package/src/mcp/tools/agent/capture.ts +202 -0
  150. package/src/mcp/tools/agent/eval.ts +161 -0
  151. package/src/mcp/tools/agent/find.ts +73 -0
  152. package/src/mcp/tools/agent/proof.ts +272 -0
  153. package/src/mcp/tools/agent/propose.ts +111 -0
  154. package/src/mcp/tools/agent/publish.ts +155 -0
  155. package/src/mcp/tools/agent/replay.ts +58 -0
  156. package/src/mcp/tools/agent/session.ts +46 -0
  157. package/src/mcp/tools/credentials/authenticate.ts +135 -0
  158. package/src/mcp/tools/credentials/build.ts +37 -0
  159. package/src/mcp/tools/credentials/cache.ts +161 -0
  160. package/src/mcp/tools/credentials/env-file.ts +101 -0
  161. package/src/mcp/tools/credentials/import.ts +72 -0
  162. package/src/mcp/tools/credentials/issue.ts +107 -0
  163. package/src/mcp/tools/credentials/list-cached.ts +66 -0
  164. package/src/mcp/tools/credentials/register.ts +49 -0
  165. package/src/mcp/tools/credentials/resolve-owner-key.ts +78 -0
  166. package/src/mcp/tools/credentials/session-cache.ts +31 -0
  167. package/src/mcp/tools/credentials/status.ts +82 -0
  168. package/src/mcp-bin.ts +7 -0
  169. package/src/old/client.ts +236 -0
  170. package/src/old/flag.ts +13 -0
  171. package/src/old/identity.ts +56 -0
  172. package/src/old/instructions.ts +30 -0
  173. package/src/old/login-cdp.ts +153 -0
  174. package/src/old/to-register.ts +234 -0
  175. package/src/old/tools/authenticate.ts +152 -0
  176. package/src/old/tools/build.ts +21 -0
  177. package/src/old/tools/me-providers.ts +42 -0
  178. package/src/old/tools/publish.ts +135 -0
  179. package/src/paths.ts +37 -0
  180. package/src/pkg.ts +24 -0
  181. package/src/proof/attestor.ts +286 -0
  182. package/src/proof/replay.ts +102 -0
  183. package/src/provider/constraints.ts +150 -0
  184. package/src/provider/draft.ts +105 -0
  185. package/src/provider/graphql.ts +42 -0
  186. package/src/provider/matcher.ts +616 -0
  187. package/src/provider/normalize.ts +65 -0
  188. package/src/provider/schema.ts +92 -0
  189. package/src/provider/secrets.ts +29 -0
  190. package/src/provider/to-version.ts +90 -0
  191. package/src/types/openapi.ts +7 -0
@@ -0,0 +1,2397 @@
1
+ // AUTO-GENERATED by packages/app/scripts/mcp-tools-gen.ts
2
+ // from packages/app/openapi.yaml.
3
+ // Run `npm run openapi:typegen --workspace=packages/agent`
4
+ // to regenerate. Do not edit by hand.
5
+ // @ts-nocheck
6
+
7
+ import { convertJsonSchemaToZod as toZod } from 'zod-from-json-schema'
8
+
9
+ export const MCP_TOOLS = {
10
+ "AddOrgMember": {
11
+ description: "Invite a member to an organization\n\nOwner only. Invites a user to the organization by email. The invitee does **not** need to be a registered user — an invite is created in either case, and an email is dispatched. The new row is returned with `status: PENDING`; it flips to `ACTIVE` on first sign-in by the invited email. `PERSONAL` organizations reject this call (409). In the current milestone the email is not actually dispatched — the invite is auto-claimed when the invitee next signs in.",
12
+ inputSchema: toZod({
13
+ "type": "object",
14
+ "properties": {
15
+ "params": {
16
+ "type": "object",
17
+ "properties": {
18
+ "orgId": {
19
+ "type": "string",
20
+ "format": "uuid"
21
+ }
22
+ },
23
+ "required": [
24
+ "orgId"
25
+ ],
26
+ "additionalProperties": false
27
+ },
28
+ "query": {
29
+ "type": "object",
30
+ "properties": {
31
+
32
+ }
33
+ },
34
+ "body": {
35
+ "type": "object",
36
+ "additionalProperties": false,
37
+ "description": "Body for inviting a member to an organization. The invitee does not need to be a registered user; an invite is created either way and an email is dispatched.",
38
+ "required": [
39
+ "email",
40
+ "role"
41
+ ],
42
+ "properties": {
43
+ "email": {
44
+ "type": "string",
45
+ "format": "email",
46
+ "description": "Email to invite. Need not match an existing `User`.",
47
+ "minLength": 3,
48
+ "maxLength": 320
49
+ },
50
+ "role": {
51
+ "type": "string",
52
+ "description": "Role a user holds in an organization. `OWNER` can invite, promote, demote, and remove members, and delete the org. `MEMBER` has read/write access to resources owned by the org but cannot manage membership. `PERSONAL` orgs have exactly one `OWNER` and reject all member-mutating operations.",
53
+ "enum": [
54
+ "OWNER",
55
+ "MEMBER"
56
+ ]
57
+ }
58
+ }
59
+ }
60
+ },
61
+ "required": [
62
+ "params",
63
+ "query",
64
+ "body"
65
+ ],
66
+ "additionalProperties": false
67
+ }),
68
+ },
69
+ "AdminOrgs": {
70
+ description: "All workspaces (admin-only)\n\nAdmin only. Lists all organizations. Search matches workspace name or any member's email address.",
71
+ inputSchema: toZod({
72
+ "type": "object",
73
+ "properties": {
74
+ "params": {
75
+ "type": "object",
76
+ "properties": {
77
+
78
+ }
79
+ },
80
+ "query": {
81
+ "type": "object",
82
+ "properties": {
83
+ "q": {
84
+ "type": "string",
85
+ "maxLength": 200
86
+ }
87
+ }
88
+ },
89
+ "body": {
90
+ "type": "object"
91
+ }
92
+ },
93
+ "required": [
94
+ "params",
95
+ "query"
96
+ ],
97
+ "additionalProperties": false
98
+ }),
99
+ },
100
+ "AdminProviders": {
101
+ description: "All verifications (admin-only)\n\nAdmin only. Lists all verifications across all organizations. Supports filtering by visibility, status, and free-text search on title/domain/slug.",
102
+ inputSchema: toZod({
103
+ "type": "object",
104
+ "properties": {
105
+ "params": {
106
+ "type": "object",
107
+ "properties": {
108
+
109
+ }
110
+ },
111
+ "query": {
112
+ "type": "object",
113
+ "properties": {
114
+ "q": {
115
+ "type": "string",
116
+ "maxLength": 200
117
+ },
118
+ "visibility": {
119
+ "type": "string",
120
+ "description": "The visibility of the entity.\n\n- `PRIVATE`: Only the owner can see the entity.\n\n- `PUBLIC`: Anyone can see the entity.",
121
+ "enum": [
122
+ "PRIVATE",
123
+ "PUBLIC"
124
+ ]
125
+ },
126
+ "status": {
127
+ "type": "string",
128
+ "description": "The status of the entity.\n\n- `ACTIVE`: The entity is active.\n\n- `ARCHIVED`: The entity is archived.",
129
+ "enum": [
130
+ "ACTIVE",
131
+ "ARCHIVED"
132
+ ]
133
+ }
134
+ }
135
+ },
136
+ "body": {
137
+ "type": "object"
138
+ }
139
+ },
140
+ "required": [
141
+ "params",
142
+ "query"
143
+ ],
144
+ "additionalProperties": false
145
+ }),
146
+ },
147
+ "AdminReviews": {
148
+ description: "Pending review queue (admin-only)\n\nAdmin only. Lists all provider versions currently awaiting review (branch = 'in_review'). Use DecideProviderVersionReview to approve or reject each version.",
149
+ inputSchema: toZod({
150
+ "type": "object",
151
+ "properties": {
152
+ "params": {
153
+ "type": "object",
154
+ "properties": {
155
+
156
+ }
157
+ },
158
+ "query": {
159
+ "type": "object",
160
+ "properties": {
161
+
162
+ }
163
+ },
164
+ "body": {
165
+ "type": "object"
166
+ }
167
+ },
168
+ "required": [
169
+ "params",
170
+ "query"
171
+ ],
172
+ "additionalProperties": false
173
+ }),
174
+ },
175
+ "CancelPublicListingRequest": {
176
+ description: "Cancel a pending public listing review request\n\nCancels a pending public listing request by moving the version from `in_review` back to `draft`. Only org members can cancel their own review requests. This allows users to withdraw a request before admin review if they change their mind.",
177
+ inputSchema: toZod({
178
+ "type": "object",
179
+ "properties": {
180
+ "params": {
181
+ "type": "object",
182
+ "properties": {
183
+ "providerId": {
184
+ "type": "string",
185
+ "format": "uuid"
186
+ },
187
+ "version": {
188
+ "type": "string",
189
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
190
+ "maxLength": 32
191
+ }
192
+ },
193
+ "required": [
194
+ "providerId",
195
+ "version"
196
+ ],
197
+ "additionalProperties": false
198
+ },
199
+ "query": {
200
+ "type": "object",
201
+ "properties": {
202
+
203
+ }
204
+ },
205
+ "body": {
206
+ "type": "object",
207
+ "additionalProperties": false,
208
+ "description": "Body for visibility change requests (request public listing or make private).",
209
+ "properties": {
210
+ "notes": {
211
+ "type": "string",
212
+ "description": "Optional note explaining the change.",
213
+ "maxLength": 10000
214
+ }
215
+ }
216
+ }
217
+ },
218
+ "required": [
219
+ "params",
220
+ "query",
221
+ "body"
222
+ ],
223
+ "additionalProperties": false
224
+ }),
225
+ },
226
+ "CreateAttachSession": {
227
+ description: "Open a device-pairing session to authorize a device\n\nOpens a short-lived (15-minute) device-pairing session. The CLI / MCP needs a bearer token to make authenticated API calls: the human opens `attachUrl`, signs in, and taps \"Authorize this device\". On confirmation the CLI receives a 2-day auth token via `GetAttachSession` polling. Linking a credential to an org is a separate step (`POST /credentials`) and is not part of pairing.",
228
+ inputSchema: toZod({
229
+ "type": "object",
230
+ "properties": {
231
+ "params": {
232
+ "type": "object",
233
+ "properties": {
234
+
235
+ }
236
+ },
237
+ "query": {
238
+ "type": "object",
239
+ "properties": {
240
+
241
+ }
242
+ },
243
+ "body": {
244
+ "type": "object"
245
+ }
246
+ },
247
+ "required": [
248
+ "params",
249
+ "query"
250
+ ],
251
+ "additionalProperties": false
252
+ }),
253
+ },
254
+ "CreateOrg": {
255
+ description: "Create an organization\n\nCreates a new `ORG`-kind organization with the caller as its first `OWNER`. The personal org is created automatically at user signup and is not created via this endpoint.",
256
+ inputSchema: toZod({
257
+ "type": "object",
258
+ "properties": {
259
+ "params": {
260
+ "type": "object",
261
+ "properties": {
262
+
263
+ }
264
+ },
265
+ "query": {
266
+ "type": "object",
267
+ "properties": {
268
+
269
+ }
270
+ },
271
+ "body": {
272
+ "type": "object",
273
+ "additionalProperties": false,
274
+ "required": [
275
+ "name"
276
+ ],
277
+ "properties": {
278
+ "name": {
279
+ "type": "string",
280
+ "minLength": 1,
281
+ "maxLength": 200
282
+ }
283
+ }
284
+ }
285
+ },
286
+ "required": [
287
+ "params",
288
+ "query",
289
+ "body"
290
+ ],
291
+ "additionalProperties": false
292
+ }),
293
+ },
294
+ "CreateProvider": {
295
+ description: "Create a verification\n\nCreate a new Reclaim verification. Use this only after `providers` returned nothing useful for the domain. The caller must be an active member of the target organization.\nCreates a new verification in the specified organization. `visibility` is coerced to `PRIVATE` at creation regardless of what's sent; the author may toggle to `PUBLIC` later via `PATCH /providers/{id}`. While `PRIVATE`, versions go to the go live freely; once `PUBLIC`, non-admin versions need admin review. See `Provider.visibility`.\nThe server also seeds an initial `0.1.0` version on the `draft` branch in the same transaction so the verification is immediately editable. Its `initialUrl` defaults to `https://<domain>`; all other version fields fall back to their schema-declared defaults (structured verification, empty requests, empty web settings). `Provider.latestVersion` stays `null` until the draft is promoted to the live channel.",
296
+ inputSchema: toZod({
297
+ "type": "object",
298
+ "properties": {
299
+ "params": {
300
+ "type": "object",
301
+ "properties": {
302
+
303
+ }
304
+ },
305
+ "query": {
306
+ "type": "object",
307
+ "properties": {
308
+
309
+ }
310
+ },
311
+ "body": {
312
+ "type": "object",
313
+ "additionalProperties": false,
314
+ "description": "`title` is optional — when omitted the dashboard renders `seoSuggestions.title` (server-derived from the scrape result or `derive_brand_name(domain)`).",
315
+ "required": [
316
+ "orgId",
317
+ "domain",
318
+ "slug"
319
+ ],
320
+ "properties": {
321
+ "orgId": {
322
+ "type": "string",
323
+ "format": "uuid"
324
+ },
325
+ "domain": {
326
+ "description": "Canonical root domain (e.g. `github.com`). No scheme, no port, no path.",
327
+ "type": "string",
328
+ "format": "hostname",
329
+ "minLength": 1,
330
+ "maxLength": 200
331
+ },
332
+ "slug": {
333
+ "description": "URL-safe identifier. Globally unique — pick something domain-specific like `github-followers`.",
334
+ "type": "string",
335
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
336
+ "minLength": 1,
337
+ "maxLength": 100
338
+ },
339
+ "title": {
340
+ "description": "Short headline shown to end-users. Defaults to a domain-derived brand name.",
341
+ "type": "string",
342
+ "minLength": 1,
343
+ "maxLength": 100
344
+ },
345
+ "description": {
346
+ "type": "string",
347
+ "minLength": 1,
348
+ "maxLength": 2000
349
+ },
350
+ "iconUrl": {
351
+ "description": "uri of the icon. Optional. If omitted, the server auto-populates from the first version's `initialUrl` (see `Provider.iconUrl`).",
352
+ "type": "string",
353
+ "format": "uri",
354
+ "maxLength": 2000
355
+ },
356
+ "visibility": {
357
+ "type": "string",
358
+ "description": "The visibility of the entity.\n\n- `PRIVATE`: Only the owner can see the entity.\n\n- `PUBLIC`: Anyone can see the entity.",
359
+ "enum": [
360
+ "PRIVATE",
361
+ "PUBLIC"
362
+ ]
363
+ },
364
+ "tags": {
365
+ "type": "array",
366
+ "maxItems": 50,
367
+ "uniqueItems": true,
368
+ "default": [
369
+
370
+ ],
371
+ "items": {
372
+ "type": "string",
373
+ "description": "A free-form label attached to an entity for grouping and filtering in listings. Must start and end with an alphanumeric character; only ASCII letters, digits, spaces, and hyphens are allowed between.",
374
+ "pattern": "^[A-Za-z0-9]([A-Za-z0-9 \\-]*[A-Za-z0-9])?$",
375
+ "minLength": 1,
376
+ "maxLength": 50
377
+ }
378
+ },
379
+ "seo": {
380
+ "type": "object",
381
+ "additionalProperties": false,
382
+ "description": "Author-set SEO fields. All optional.\n\nEach field is paired with a server-derived default of the\nsame name on `Provider.seoSuggestions`. Renderers pick the\neffective value per field:\n\n effective.<field> = seo.<field> ?? seoSuggestions.<field>\n\nSet a field here to override; leave it unset to let the\ndefault win. Both objects are returned on every\n`GET /providers/{id}` — the builder does not pre-merge.\n",
383
+ "properties": {
384
+ "brandUrl": {
385
+ "type": "string",
386
+ "format": "uri",
387
+ "description": "Canonical homepage of the brand (e.g. `https://google.com`). Used in brand-link cards and JSON-LD.",
388
+ "maxLength": 2000
389
+ },
390
+ "primaryDataPoint": {
391
+ "type": "string",
392
+ "description": "Headline data point — the single most-important variable this provider can verify (e.g. `subscriber count`). Used in the provider's SEO title.",
393
+ "maxLength": 200
394
+ },
395
+ "dataPoints": {
396
+ "type": "array",
397
+ "description": "Full list of data points this provider can verify.",
398
+ "maxItems": 50,
399
+ "items": {
400
+ "type": "string",
401
+ "maxLength": 200
402
+ }
403
+ },
404
+ "titleOverride": {
405
+ "type": "string",
406
+ "description": "Replaces the renderer's composed `<title>` / OG title. Use when the default composition reads awkwardly.",
407
+ "maxLength": 200
408
+ },
409
+ "descriptionOverride": {
410
+ "type": "string",
411
+ "description": "Replaces the renderer's composed `<meta name=\"description\">` / OG description.",
412
+ "maxLength": 320
413
+ }
414
+ }
415
+ }
416
+ }
417
+ }
418
+ },
419
+ "required": [
420
+ "params",
421
+ "query",
422
+ "body"
423
+ ],
424
+ "additionalProperties": false
425
+ }),
426
+ },
427
+ "CreateProviderVersion": {
428
+ description: "Create a new verification version\n\nCreates a new version of the verification. The starting branch\ndepends on the verification's `visibility` and the caller's role:\n\n- `PRIVATE` verification (any caller): the live channel (no review).\n\n- `PUBLIC` verification, admin caller (Reclaim staff): the live channel\n (no review).\n\n- `PUBLIC` verification, non-admin caller: `draft` (or `ai` if\n authored by the AI assistant). Must pass review (see\n `POST /providers/{id}/versions/{version}/review`) before\n reaching the live channel.\n",
429
+ inputSchema: toZod({
430
+ "type": "object",
431
+ "properties": {
432
+ "params": {
433
+ "type": "object",
434
+ "properties": {
435
+ "providerId": {
436
+ "type": "string",
437
+ "format": "uuid"
438
+ }
439
+ },
440
+ "required": [
441
+ "providerId"
442
+ ],
443
+ "additionalProperties": false
444
+ },
445
+ "query": {
446
+ "type": "object",
447
+ "properties": {
448
+
449
+ }
450
+ },
451
+ "body": {
452
+ "type": "object",
453
+ "additionalProperties": false,
454
+ "description": "Body for creating a new version of a provider. Every new version starts on the `draft` branch — see `CreateProviderVersion`. The request body never sets `branch` directly; going live is a separate, explicit step (publish for PRIVATE, submit-for-review → approve for PUBLIC). The version's `verificationType` is always `structured` and is not settable here; a `prompt` field is reserved for a future AI authoring flow and is also not accepted on this surface.",
455
+ "required": [
456
+ "initialUrl",
457
+ "requests",
458
+ "allowedJsRequests",
459
+ "webSettings"
460
+ ],
461
+ "properties": {
462
+ "version": {
463
+ "type": "object",
464
+ "additionalProperties": false,
465
+ "required": [
466
+ "major",
467
+ "minor",
468
+ "patch"
469
+ ],
470
+ "properties": {
471
+ "major": {
472
+ "type": "integer",
473
+ "minimum": 0
474
+ },
475
+ "minor": {
476
+ "type": "integer",
477
+ "minimum": 0
478
+ },
479
+ "patch": {
480
+ "type": "integer",
481
+ "minimum": 0
482
+ },
483
+ "branch": {
484
+ "type": "string",
485
+ "description": "Branch (lifecycle stage) of this provider version.\n\n- `ai`: changes authored by the AI assistant live on this branch.\n\n- `draft`: a human is actively editing the version.\n\n- `in_review`: the author has submitted the version to be made\n public and it is awaiting review. On approval the branch tag\n is cleared (the version is promoted to the live channel and becomes\n public).\n\n- `rejected`: review concluded with a rejection. When the author\n addresses the feedback the branch transitions back to\n `in_review`.",
486
+ "enum": [
487
+ "ai",
488
+ "draft",
489
+ "in_review",
490
+ "rejected"
491
+ ]
492
+ },
493
+ "buildNumber": {
494
+ "type": "integer",
495
+ "description": "Build number for the provider version",
496
+ "minimum": 0
497
+ }
498
+ }
499
+ },
500
+ "initialUrl": {
501
+ "type": "string",
502
+ "format": "uri",
503
+ "maxLength": 300
504
+ },
505
+ "requests": {
506
+ "type": "array",
507
+ "minItems": 0,
508
+ "default": [
509
+
510
+ ],
511
+ "items": {
512
+ "type": "object",
513
+ "additionalProperties": false,
514
+ "description": "A matcher for one HTTP request in observed traffic, together with the response constraints that must hold for a Reclaim proof over that request to be valid. Used by interceptors, in-page injections, and LLM agents.",
515
+ "required": [
516
+ "url",
517
+ "method"
518
+ ],
519
+ "properties": {
520
+ "url": {
521
+ "type": "string",
522
+ "description": "The URL or generic path of the HTTP request."
523
+ },
524
+ "method": {
525
+ "type": "string",
526
+ "description": "The HTTP method used for the request.",
527
+ "enum": [
528
+ "GET",
529
+ "POST",
530
+ "PUT",
531
+ "PATCH",
532
+ "DELETE"
533
+ ]
534
+ },
535
+ "requestBodyTemplate": {
536
+ "type": "string",
537
+ "description": "Template used to match or capture an outgoing request body. Template can use regex templates as placeholders. For example, to match an outgoing request body that contains a request ID, you can use the following template: `(?<requestId>.*)`.",
538
+ "maxLength": 100000
539
+ },
540
+ "credentials": {
541
+ "type": "string",
542
+ "description": "Mirrors the Fetch API `RequestCredentials` value used when issuing the request — controls whether cookies and auth headers are sent.",
543
+ "enum": [
544
+ "omit",
545
+ "same-origin",
546
+ "include"
547
+ ]
548
+ },
549
+ "writeRedactionMode": {
550
+ "type": "string",
551
+ "description": "How the matched portion of the response should be redacted before the transcript is handed to the attestor.\n- `zk`: redact using a zero-knowledge proof over the original\n bytes.\n\n- `key-update`: redact by performing a TLS key update so the\n attestor never observes the matched bytes in cleartext.",
552
+ "enum": [
553
+ "zk",
554
+ "key-update"
555
+ ]
556
+ },
557
+ "additionalClientOptions": {
558
+ "type": "object",
559
+ "additionalProperties": false,
560
+ "description": "Apply TLS configuration when creating the tunnel to the attestor.",
561
+ "properties": {
562
+ "supportedProtocolVersions": {
563
+ "type": "array",
564
+ "description": "TLS protocol versions the client is allowed to negotiate.",
565
+ "minItems": 1,
566
+ "uniqueItems": true,
567
+ "items": {
568
+ "type": "string",
569
+ "enum": [
570
+ "TLS1_2",
571
+ "TLS1_3"
572
+ ]
573
+ }
574
+ }
575
+ }
576
+ },
577
+ "matches": {
578
+ "type": "array",
579
+ "description": "A list of match conditions for the response.",
580
+ "minItems": 1,
581
+ "items": {
582
+ "type": "object",
583
+ "additionalProperties": false,
584
+ "description": "Specifies a rule to match against a string in response to validate proof content.",
585
+ "required": [
586
+ "type",
587
+ "value"
588
+ ],
589
+ "properties": {
590
+ "isOptional": {
591
+ "type": "boolean",
592
+ "description": "If true, the match condition is optional and won't fail if absent",
593
+ "default": false
594
+ },
595
+ "description": {
596
+ "type": "string",
597
+ "description": "The description of the field that is extracted using this match rule",
598
+ "minLength": 1,
599
+ "maxLength": 1000
600
+ },
601
+ "order": {
602
+ "type": "integer",
603
+ "description": "The order in which the field should be displayed to user in UI",
604
+ "minimum": 0
605
+ },
606
+ "type": {
607
+ "type": "string",
608
+ "description": "The matching mechanism to use value as against response. Typically regex or simple string containment",
609
+ "enum": [
610
+ "regex",
611
+ "contains"
612
+ ]
613
+ },
614
+ "value": {
615
+ "type": "string",
616
+ "description": "The pattern or value to look for in the response. When `type` is 'contains', supports template variable declaration using `{{variable}}` syntax. When `type` is 'regex', can be used to extract variables using regex named groups."
617
+ },
618
+ "extract": {
619
+ "type": "object",
620
+ "description": "Which portions to select from a response. These are selected in order, xpath => jsonPath => regex * These redactions are done client side and only the selected portions are sent to the attestor. The attestor will only be able to see the selected portions alongside the first line of the HTTP response (i.e. \"HTTP/1.1 200 OK\")",
621
+ "properties": {
622
+ "xPath": {
623
+ "type": "string",
624
+ "description": "expect an HTML response, and to contain a certain xpath for eg. \"/html/body/div.a1/div.a2/span.a5\""
625
+ },
626
+ "jsonPath": {
627
+ "type": "string",
628
+ "description": "expect a JSON response, retrieve the item at this path using dot notation for e.g. 'email.addresses.0'"
629
+ },
630
+ "regex": {
631
+ "type": "string",
632
+ "description": "select a regex match from the response"
633
+ },
634
+ "hash": {
635
+ "type": "string",
636
+ "description": "If provided, the value inside will be hashed instead of being redacted. Useful for cases where the data inside is an identifiying piece of information that you don't want to reveal to the attestor, eg. an email address.\nIf the hash function produces more bytes than the original value, the hash will be truncated.\nEg. if hash is enabled, the original value is \"hello\", and hashed is \"a1b2c\", then the attestor will only see \"a1b2c\".\nNote: if a regex with named groups is provided, only the named groups will be hashed.",
637
+ "enum": [
638
+ "oprf",
639
+ "oprf-mpc",
640
+ "oprf-raw"
641
+ ]
642
+ }
643
+ }
644
+ }
645
+ }
646
+ }
647
+ }
648
+ }
649
+ }
650
+ },
651
+ "allowedJsRequests": {
652
+ "type": "array",
653
+ "minItems": 0,
654
+ "default": [
655
+
656
+ ],
657
+ "items": {
658
+ "type": "object",
659
+ "additionalProperties": false,
660
+ "description": "A template for selecting request",
661
+ "allOf": [
662
+ {
663
+ "$ref": "#/components/schemas/RequestSelection"
664
+ },
665
+ {
666
+ "type": "object",
667
+ "required": [
668
+ "multiple",
669
+ "required"
670
+ ],
671
+ "properties": {
672
+ "multiple": {
673
+ "type": "boolean",
674
+ "description": "If true, the template is allowed for multiple requests. Useful for requests like paginated API calls.",
675
+ "default": true
676
+ },
677
+ "required": {
678
+ "type": "boolean",
679
+ "description": "If true, a request is required to match with this template. If not requests matches this template in proof, then validation fails.",
680
+ "default": true
681
+ }
682
+ }
683
+ }
684
+ ]
685
+ }
686
+ },
687
+ "webSettings": {
688
+ "type": "object",
689
+ "additionalProperties": false,
690
+ "description": "Settings used by the web-based verification client.",
691
+ "properties": {
692
+ "geoLocation": {
693
+ "type": "string",
694
+ "description": "Geographic location (e.g. ISO country code or {{DYNAMIC_GEO}} to use user's geo location) the verification should appear to originate from.",
695
+ "maxLength": 15
696
+ },
697
+ "clientOptions": {
698
+ "type": "object",
699
+ "additionalProperties": false,
700
+ "description": "Options that influence how the web verification client behaves.",
701
+ "properties": {
702
+ "portal": {
703
+ "type": "object",
704
+ "additionalProperties": false,
705
+ "description": "Options that influence how the portal verification client behaves.",
706
+ "properties": {
707
+ "useProxy": {
708
+ "type": "boolean",
709
+ "description": "When true, network traffic from the portal client and attestation is routed through a proxy.",
710
+ "default": false
711
+ },
712
+ "userAgent": {
713
+ "type": "string",
714
+ "description": "User-agent string used for platform verification.",
715
+ "maxLength": 500
716
+ }
717
+ }
718
+ },
719
+ "inapp": {
720
+ "type": "object",
721
+ "additionalProperties": false,
722
+ "description": "Options that influence how the in-app verification client behaves.",
723
+ "properties": {
724
+ "interceptorOptions": {
725
+ "type": "object",
726
+ "additionalProperties": false,
727
+ "required": [
728
+ "interceptorType"
729
+ ],
730
+ "properties": {
731
+ "interceptorType": {
732
+ "type": "string",
733
+ "description": "How traffic interception is implemented.",
734
+ "enum": [
735
+ "HAWKEYE",
736
+ "MSWJS",
737
+ "CDP"
738
+ ]
739
+ },
740
+ "isDocumentRequestReplayEnabled": {
741
+ "type": "boolean",
742
+ "description": "Whether the main document request is replayed via the attestor",
743
+ "default": false
744
+ },
745
+ "interceptorSettings": {
746
+ "type": "string",
747
+ "description": "Free-form configuration passed through to the interceptor implementation selected by `interceptorType`. Keys and value shapes are defined by the chosen interceptor.",
748
+ "contentMediaType": "application/json"
749
+ }
750
+ }
751
+ },
752
+ "userAgents": {
753
+ "type": "object",
754
+ "additionalProperties": false,
755
+ "description": "User-agent strings keyed by platform.",
756
+ "properties": {
757
+ "android": {
758
+ "type": "string",
759
+ "description": "User-agent string used for platform verification.",
760
+ "maxLength": 500
761
+ },
762
+ "ios": {
763
+ "type": "string",
764
+ "description": "User-agent string used for platform verification.",
765
+ "maxLength": 500
766
+ }
767
+ }
768
+ }
769
+ }
770
+ }
771
+ }
772
+ },
773
+ "jsUserScripts": {
774
+ "type": "string",
775
+ "description": "JavaScript snippets injected into the page which runs before every page load. `window.Reclaim.` APIs are available to these scripts to request actions to the client like claim creation.",
776
+ "maxLength": 1000000
777
+ }
778
+ }
779
+ },
780
+ "requiredParameters": {
781
+ "type": "object",
782
+ "description": "Map of parameter names needed (optional or required) to use this provider to their human-readable descriptions/labels. Values are plain strings shown alongside the field in dashboards and prompts.",
783
+ "maxProperties": 50,
784
+ "additionalProperties": {
785
+ "type": "string",
786
+ "maxLength": 500
787
+ }
788
+ },
789
+ "notes": {
790
+ "type": "string",
791
+ "description": "Free-form change note recorded on `createMetadata`.",
792
+ "maxLength": 10000
793
+ }
794
+ }
795
+ }
796
+ },
797
+ "required": [
798
+ "params",
799
+ "query",
800
+ "body"
801
+ ],
802
+ "additionalProperties": false
803
+ }),
804
+ },
805
+ "DecideProviderVersionReview": {
806
+ description: "Record a decision on a verification version review\n\nAdmin only (Reclaim staff). Approves or rejects a verification version currently on the `in_review` branch. `APPROVED` clears the branch tag and promotes the version to the live channel; `REJECTED` moves it to the `rejected` branch where the author can address feedback and resubmit. A rejected version stays rejected — the author either fixes and resubmits, or abandons it.\nUntil RBAC is designed, \"admin\" is detected via the user's email domain (`@reclaimprotocol.org`). Non-admin callers receive a 403.",
807
+ inputSchema: toZod({
808
+ "type": "object",
809
+ "properties": {
810
+ "params": {
811
+ "type": "object",
812
+ "properties": {
813
+ "providerId": {
814
+ "type": "string",
815
+ "format": "uuid"
816
+ },
817
+ "version": {
818
+ "type": "string",
819
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
820
+ "maxLength": 32
821
+ }
822
+ },
823
+ "required": [
824
+ "providerId",
825
+ "version"
826
+ ],
827
+ "additionalProperties": false
828
+ },
829
+ "query": {
830
+ "type": "object",
831
+ "properties": {
832
+
833
+ }
834
+ },
835
+ "body": {
836
+ "type": "object",
837
+ "additionalProperties": false,
838
+ "description": "Body for recording a decision on a provider version in `in_review`. On `APPROVED` the branch tag is cleared and the version is promoted to the live channel (becomes public). On `REJECTED` the branch becomes `rejected`.",
839
+ "required": [
840
+ "decision"
841
+ ],
842
+ "properties": {
843
+ "decision": {
844
+ "type": "string",
845
+ "enum": [
846
+ "APPROVED",
847
+ "REJECTED"
848
+ ]
849
+ },
850
+ "notes": {
851
+ "type": "string",
852
+ "description": "Free-form rationale shown to the author.",
853
+ "maxLength": 10000
854
+ }
855
+ }
856
+ }
857
+ },
858
+ "required": [
859
+ "params",
860
+ "query",
861
+ "body"
862
+ ],
863
+ "additionalProperties": false
864
+ }),
865
+ },
866
+ "DeleteProvider": {
867
+ description: "Delete a verification\n\nOwner of the verification's organization only. Soft-archives the verification (sets `status` to `ARCHIVED`) so historical references remain resolvable. Supports optimistic concurrency via `If-Match`.",
868
+ inputSchema: toZod({
869
+ "type": "object",
870
+ "properties": {
871
+ "params": {
872
+ "type": "object",
873
+ "properties": {
874
+ "providerId": {
875
+ "type": "string",
876
+ "format": "uuid"
877
+ }
878
+ },
879
+ "required": [
880
+ "providerId"
881
+ ],
882
+ "additionalProperties": false
883
+ },
884
+ "query": {
885
+ "type": "object",
886
+ "properties": {
887
+
888
+ }
889
+ },
890
+ "headers": {
891
+ "type": "object",
892
+ "properties": {
893
+ "If-Match": {
894
+ "type": "string",
895
+ "maxLength": 128,
896
+ "description": "Opaque `ETag` from a prior GET on the same resource. When\nsupplied, the server applies optimistic concurrency: the\nmutation fails with `412 Precondition Failed` if the\nresource has been modified since. Omit for last-write-wins.\n"
897
+ }
898
+ }
899
+ },
900
+ "body": {
901
+ "type": "object"
902
+ }
903
+ },
904
+ "required": [
905
+ "params",
906
+ "query"
907
+ ],
908
+ "additionalProperties": false
909
+ }),
910
+ },
911
+ "DeleteProviderVersion": {
912
+ description: "Delete a verification version\n\nSoft-archives a version on the `draft`, `ai`, or `rejected` branch — sets `status` to `ARCHIVED` so history is preserved. Trunk (live) and `in_review` versions cannot be archived this way; archive the parent verification instead. Supports optimistic concurrency via `If-Match`.",
913
+ inputSchema: toZod({
914
+ "type": "object",
915
+ "properties": {
916
+ "params": {
917
+ "type": "object",
918
+ "properties": {
919
+ "providerId": {
920
+ "type": "string",
921
+ "format": "uuid"
922
+ },
923
+ "version": {
924
+ "type": "string",
925
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
926
+ "maxLength": 32
927
+ }
928
+ },
929
+ "required": [
930
+ "providerId",
931
+ "version"
932
+ ],
933
+ "additionalProperties": false
934
+ },
935
+ "query": {
936
+ "type": "object",
937
+ "properties": {
938
+
939
+ }
940
+ },
941
+ "headers": {
942
+ "type": "object",
943
+ "properties": {
944
+ "If-Match": {
945
+ "type": "string",
946
+ "maxLength": 128,
947
+ "description": "Opaque `ETag` from a prior GET on the same resource. When\nsupplied, the server applies optimistic concurrency: the\nmutation fails with `412 Precondition Failed` if the\nresource has been modified since. Omit for last-write-wins.\n"
948
+ }
949
+ }
950
+ },
951
+ "body": {
952
+ "type": "object"
953
+ }
954
+ },
955
+ "required": [
956
+ "params",
957
+ "query"
958
+ ],
959
+ "additionalProperties": false
960
+ }),
961
+ },
962
+ "GetAttachSession": {
963
+ description: "Poll a pairing session\n\nAnonymous poll endpoint used by the CLI / MCP while it waits for the human to complete the dashboard step. Once `status` is `LINKED`, the response includes a `token` (2-day bearer token) the CLI / MCP can use for authenticated API calls. Expired or unknown codes return `404`.",
964
+ inputSchema: toZod({
965
+ "type": "object",
966
+ "properties": {
967
+ "params": {
968
+ "type": "object",
969
+ "properties": {
970
+ "code": {
971
+ "type": "string",
972
+ "description": "Five-character device-pairing code. The CLI / MCP shows this to the user, who types it into the dashboard's `/attach` page to confirm the link. Always uppercase alphanumeric; chars `O`/`0` and `I`/`1` are excluded to avoid ambiguity when copied from a terminal.",
973
+ "pattern": "^[A-HJ-NP-Z2-9]{5}$",
974
+ "minLength": 5,
975
+ "maxLength": 5
976
+ }
977
+ },
978
+ "required": [
979
+ "code"
980
+ ],
981
+ "additionalProperties": false
982
+ },
983
+ "query": {
984
+ "type": "object",
985
+ "properties": {
986
+
987
+ }
988
+ },
989
+ "body": {
990
+ "type": "object"
991
+ }
992
+ },
993
+ "required": [
994
+ "params",
995
+ "query"
996
+ ],
997
+ "additionalProperties": false
998
+ }),
999
+ },
1000
+ "GetCredential": {
1001
+ description: "Get a credential\n\nReturns the credential row. Visibility: anyone can fetch an anonymous (`orgId` null) credential by id; linked credentials are visible only to active members of the owning org.",
1002
+ inputSchema: toZod({
1003
+ "type": "object",
1004
+ "properties": {
1005
+ "params": {
1006
+ "type": "object",
1007
+ "properties": {
1008
+ "credentialId": {
1009
+ "type": "string",
1010
+ "format": "uuid",
1011
+ "description": "Stable id for a `Credential` row."
1012
+ }
1013
+ },
1014
+ "required": [
1015
+ "credentialId"
1016
+ ],
1017
+ "additionalProperties": false
1018
+ },
1019
+ "query": {
1020
+ "type": "object",
1021
+ "properties": {
1022
+
1023
+ }
1024
+ },
1025
+ "body": {
1026
+ "type": "object"
1027
+ }
1028
+ },
1029
+ "required": [
1030
+ "params",
1031
+ "query"
1032
+ ],
1033
+ "additionalProperties": false
1034
+ }),
1035
+ },
1036
+ "GetCredentialByAddress": {
1037
+ description: "Look up a credential by its lowercase ETH address\n\nCompanion to `GET /credentials/{credentialId}`. The MCP / CLI knows the credential by its address (the public handle the user actually types) rather than by its UUID id, so this shortcut returns the same `Credential` shape keyed on the address. Visibility rules mirror `GetCredential`: anonymous credentials are world-readable; linked credentials are visible only to active members of the owning org. Bumps `lastUsedAt` so the dashboard shows liveness.",
1038
+ inputSchema: toZod({
1039
+ "type": "object",
1040
+ "properties": {
1041
+ "params": {
1042
+ "type": "object",
1043
+ "properties": {
1044
+ "address": {
1045
+ "type": "string",
1046
+ "description": "Lowercase Ethereum address (no EIP-55 mixed-case checksum). The client derives this from the public key via keccak-256 of the uncompressed pubkey minus the `0x04` prefix, taking the last 20 bytes. The server re-validates the format on insert but does not re-derive from the public key — that match is the client's responsibility.",
1047
+ "pattern": "^0x[0-9a-f]{40}$",
1048
+ "minLength": 42,
1049
+ "maxLength": 42
1050
+ }
1051
+ },
1052
+ "required": [
1053
+ "address"
1054
+ ],
1055
+ "additionalProperties": false
1056
+ },
1057
+ "query": {
1058
+ "type": "object",
1059
+ "properties": {
1060
+
1061
+ }
1062
+ },
1063
+ "body": {
1064
+ "type": "object"
1065
+ }
1066
+ },
1067
+ "required": [
1068
+ "params",
1069
+ "query"
1070
+ ],
1071
+ "additionalProperties": false
1072
+ }),
1073
+ },
1074
+ "GetMe": {
1075
+ description: "Get the authenticated user",
1076
+ inputSchema: toZod({
1077
+ "type": "object",
1078
+ "properties": {
1079
+ "params": {
1080
+ "type": "object",
1081
+ "properties": {
1082
+
1083
+ }
1084
+ },
1085
+ "query": {
1086
+ "type": "object",
1087
+ "properties": {
1088
+
1089
+ }
1090
+ },
1091
+ "body": {
1092
+ "type": "object"
1093
+ }
1094
+ },
1095
+ "required": [
1096
+ "params",
1097
+ "query"
1098
+ ],
1099
+ "additionalProperties": false
1100
+ }),
1101
+ },
1102
+ "GetOrg": {
1103
+ description: "Get an organization",
1104
+ inputSchema: toZod({
1105
+ "type": "object",
1106
+ "properties": {
1107
+ "params": {
1108
+ "type": "object",
1109
+ "properties": {
1110
+ "orgId": {
1111
+ "type": "string",
1112
+ "format": "uuid"
1113
+ }
1114
+ },
1115
+ "required": [
1116
+ "orgId"
1117
+ ],
1118
+ "additionalProperties": false
1119
+ },
1120
+ "query": {
1121
+ "type": "object",
1122
+ "properties": {
1123
+
1124
+ }
1125
+ },
1126
+ "body": {
1127
+ "type": "object"
1128
+ }
1129
+ },
1130
+ "required": [
1131
+ "params",
1132
+ "query"
1133
+ ],
1134
+ "additionalProperties": false
1135
+ }),
1136
+ },
1137
+ "GetOrgBilling": {
1138
+ description: "Get the billing record for an organization\n\nOwner only. Returns `404` when no billing has been set; presence of the row is what promotes the org's credentials out of sandbox mode (see `Credential.mode`).",
1139
+ inputSchema: toZod({
1140
+ "type": "object",
1141
+ "properties": {
1142
+ "params": {
1143
+ "type": "object",
1144
+ "properties": {
1145
+ "orgId": {
1146
+ "type": "string",
1147
+ "format": "uuid"
1148
+ }
1149
+ },
1150
+ "required": [
1151
+ "orgId"
1152
+ ],
1153
+ "additionalProperties": false
1154
+ },
1155
+ "query": {
1156
+ "type": "object",
1157
+ "properties": {
1158
+
1159
+ }
1160
+ },
1161
+ "body": {
1162
+ "type": "object"
1163
+ }
1164
+ },
1165
+ "required": [
1166
+ "params",
1167
+ "query"
1168
+ ],
1169
+ "additionalProperties": false
1170
+ }),
1171
+ },
1172
+ "GetProvider": {
1173
+ description: "Get a verification\n\nFetch a single Reclaim verification by id. Returns every field needed\nto integrate it into a flow: domain, the live version (initialUrl + requests),\nand the data points it can prove. Use `providers` first if you only\nhave a query string.\n\nReturns the verification record.\n\n**Canonical URL.** For SEO and stable sharing, the canonical\nHTML URL for a verification is `/providers/{providerId}/{slug}`\n(see `GetProviderBySlug`). HTML callers (`Accept: text/html`)\nthat hit this route — which omits the slug — receive a `301`\nredirect to the slugged URL. JSON callers\n(`Accept: application/json`) receive the body directly without\nredirect; the slug is on the response.\n",
1174
+ inputSchema: toZod({
1175
+ "type": "object",
1176
+ "properties": {
1177
+ "params": {
1178
+ "type": "object",
1179
+ "properties": {
1180
+ "providerId": {
1181
+ "type": "string",
1182
+ "format": "uuid"
1183
+ }
1184
+ },
1185
+ "required": [
1186
+ "providerId"
1187
+ ],
1188
+ "additionalProperties": false
1189
+ },
1190
+ "query": {
1191
+ "type": "object",
1192
+ "properties": {
1193
+
1194
+ }
1195
+ },
1196
+ "body": {
1197
+ "type": "object"
1198
+ }
1199
+ },
1200
+ "required": [
1201
+ "params",
1202
+ "query"
1203
+ ],
1204
+ "additionalProperties": false
1205
+ }),
1206
+ },
1207
+ "GetProviderVersion": {
1208
+ description: "Get a specific verification version",
1209
+ inputSchema: toZod({
1210
+ "type": "object",
1211
+ "properties": {
1212
+ "params": {
1213
+ "type": "object",
1214
+ "properties": {
1215
+ "providerId": {
1216
+ "type": "string",
1217
+ "format": "uuid"
1218
+ },
1219
+ "version": {
1220
+ "type": "string",
1221
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
1222
+ "maxLength": 32
1223
+ }
1224
+ },
1225
+ "required": [
1226
+ "providerId",
1227
+ "version"
1228
+ ],
1229
+ "additionalProperties": false
1230
+ },
1231
+ "query": {
1232
+ "type": "object",
1233
+ "properties": {
1234
+
1235
+ }
1236
+ },
1237
+ "body": {
1238
+ "type": "object"
1239
+ }
1240
+ },
1241
+ "required": [
1242
+ "params",
1243
+ "query"
1244
+ ],
1245
+ "additionalProperties": false
1246
+ }),
1247
+ },
1248
+ "GetUser": {
1249
+ description: "Get a user's profile\n\nReturns a user record. Visible to: the user themselves, or any member of an organization the subject also belongs to.",
1250
+ inputSchema: toZod({
1251
+ "type": "object",
1252
+ "properties": {
1253
+ "params": {
1254
+ "type": "object",
1255
+ "properties": {
1256
+ "userId": {
1257
+ "type": "string",
1258
+ "format": "uuid"
1259
+ }
1260
+ },
1261
+ "required": [
1262
+ "userId"
1263
+ ],
1264
+ "additionalProperties": false
1265
+ },
1266
+ "query": {
1267
+ "type": "object",
1268
+ "properties": {
1269
+
1270
+ }
1271
+ },
1272
+ "body": {
1273
+ "type": "object"
1274
+ }
1275
+ },
1276
+ "required": [
1277
+ "params",
1278
+ "query"
1279
+ ],
1280
+ "additionalProperties": false
1281
+ }),
1282
+ },
1283
+ "LinkCredential": {
1284
+ description: "Link a credential to an organization\n\nLinks an ETH credential to an organization — registering it directly, or attaching an already-known one (matched by `address`). The private key MUST NOT leave the client — only the derived address and uncompressed public key are sent. `orgId` is required and the caller must be allowed to edit it. Idempotent for the same `(address, orgId)`. (Anonymous credentials live client-side; they are only stored here once linked.)",
1285
+ inputSchema: toZod({
1286
+ "type": "object",
1287
+ "properties": {
1288
+ "params": {
1289
+ "type": "object",
1290
+ "properties": {
1291
+
1292
+ }
1293
+ },
1294
+ "query": {
1295
+ "type": "object",
1296
+ "properties": {
1297
+
1298
+ }
1299
+ },
1300
+ "body": {
1301
+ "type": "object",
1302
+ "additionalProperties": false,
1303
+ "description": "Body for `POST /credentials`. Only the lowercase ETH `address` is sent — the private key MUST NOT leave the client, and the public key is not sent (the client derives the address from the key: keccak-256 of the uncompressed pubkey minus its `0x04` prefix, last 20 bytes, lowercase hex).",
1304
+ "required": [
1305
+ "address",
1306
+ "orgId"
1307
+ ],
1308
+ "properties": {
1309
+ "address": {
1310
+ "type": "string",
1311
+ "description": "Lowercase Ethereum address (no EIP-55 mixed-case checksum). The client derives this from the public key via keccak-256 of the uncompressed pubkey minus the `0x04` prefix, taking the last 20 bytes. The server re-validates the format on insert but does not re-derive from the public key — that match is the client's responsibility.",
1312
+ "pattern": "^0x[0-9a-f]{40}$",
1313
+ "minLength": 42,
1314
+ "maxLength": 42
1315
+ },
1316
+ "orgId": {
1317
+ "type": "string",
1318
+ "format": "uuid"
1319
+ },
1320
+ "label": {
1321
+ "type": "string",
1322
+ "description": "Optional human-readable label.",
1323
+ "minLength": 1,
1324
+ "maxLength": 100
1325
+ }
1326
+ }
1327
+ }
1328
+ },
1329
+ "required": [
1330
+ "params",
1331
+ "query",
1332
+ "body"
1333
+ ],
1334
+ "additionalProperties": false
1335
+ }),
1336
+ },
1337
+ "ListOrgCredentials": {
1338
+ description: "List credentials linked to an organization\n\nReturns every credential whose `orgId` equals the path parameter. Caller must be an active member of the org.",
1339
+ inputSchema: toZod({
1340
+ "type": "object",
1341
+ "properties": {
1342
+ "params": {
1343
+ "type": "object",
1344
+ "properties": {
1345
+ "orgId": {
1346
+ "type": "string",
1347
+ "format": "uuid"
1348
+ }
1349
+ },
1350
+ "required": [
1351
+ "orgId"
1352
+ ],
1353
+ "additionalProperties": false
1354
+ },
1355
+ "query": {
1356
+ "type": "object",
1357
+ "properties": {
1358
+
1359
+ }
1360
+ },
1361
+ "body": {
1362
+ "type": "object"
1363
+ }
1364
+ },
1365
+ "required": [
1366
+ "params",
1367
+ "query"
1368
+ ],
1369
+ "additionalProperties": false
1370
+ }),
1371
+ },
1372
+ "ListOrgs": {
1373
+ description: "List organizations the caller belongs to",
1374
+ inputSchema: toZod({
1375
+ "type": "object",
1376
+ "properties": {
1377
+ "params": {
1378
+ "type": "object",
1379
+ "properties": {
1380
+
1381
+ }
1382
+ },
1383
+ "query": {
1384
+ "type": "object",
1385
+ "properties": {
1386
+ "cursor": {
1387
+ "type": "string",
1388
+ "maxLength": 500
1389
+ }
1390
+ }
1391
+ },
1392
+ "body": {
1393
+ "type": "object"
1394
+ }
1395
+ },
1396
+ "required": [
1397
+ "params",
1398
+ "query"
1399
+ ],
1400
+ "additionalProperties": false
1401
+ }),
1402
+ },
1403
+ "ListProviderVersions": {
1404
+ description: "List a verification's versions\n\nLists versions visible to the caller. Non-public branches (`ai`, `draft`, `in_review`, `rejected`) are only visible to members of the verification's owning organization.",
1405
+ inputSchema: toZod({
1406
+ "type": "object",
1407
+ "properties": {
1408
+ "params": {
1409
+ "type": "object",
1410
+ "properties": {
1411
+ "providerId": {
1412
+ "type": "string",
1413
+ "format": "uuid"
1414
+ }
1415
+ },
1416
+ "required": [
1417
+ "providerId"
1418
+ ],
1419
+ "additionalProperties": false
1420
+ },
1421
+ "query": {
1422
+ "type": "object",
1423
+ "properties": {
1424
+ "cursor": {
1425
+ "type": "string",
1426
+ "maxLength": 500
1427
+ }
1428
+ }
1429
+ },
1430
+ "body": {
1431
+ "type": "object"
1432
+ }
1433
+ },
1434
+ "required": [
1435
+ "params",
1436
+ "query"
1437
+ ],
1438
+ "additionalProperties": false
1439
+ }),
1440
+ },
1441
+ "MakePrivate": {
1442
+ description: "Change a PUBLIC provider back to PRIVATE\n\nChanges a PUBLIC provider's visibility to PRIVATE. Unlike the reverse (PRIVATE → PUBLIC), this does not require review since it restricts rather than expands access. Existing live versions remain but are no longer publicly listed.",
1443
+ inputSchema: toZod({
1444
+ "type": "object",
1445
+ "properties": {
1446
+ "params": {
1447
+ "type": "object",
1448
+ "properties": {
1449
+ "providerId": {
1450
+ "type": "string",
1451
+ "format": "uuid"
1452
+ }
1453
+ },
1454
+ "required": [
1455
+ "providerId"
1456
+ ],
1457
+ "additionalProperties": false
1458
+ },
1459
+ "query": {
1460
+ "type": "object",
1461
+ "properties": {
1462
+
1463
+ }
1464
+ },
1465
+ "body": {
1466
+ "type": "object",
1467
+ "additionalProperties": false,
1468
+ "description": "Body for visibility change requests (request public listing or make private).",
1469
+ "properties": {
1470
+ "notes": {
1471
+ "type": "string",
1472
+ "description": "Optional note explaining the change.",
1473
+ "maxLength": 10000
1474
+ }
1475
+ }
1476
+ }
1477
+ },
1478
+ "required": [
1479
+ "params",
1480
+ "query",
1481
+ "body"
1482
+ ],
1483
+ "additionalProperties": false
1484
+ }),
1485
+ },
1486
+ "Providers": {
1487
+ description: "Search verifications\n\nSearch published Reclaim verifications by domain or data point. A verification is the recipe an end-user follows to prove something about themselves (e.g. \"I have N followers on Twitter\"). Returns a list of matches. Call this BEFORE `create_provider` — most popular domains already have a public verification you can reuse.\nCatalog page listing all verifications. Returns a paginated list of verifications the caller can see. Public verifications are visible to everyone; private verifications are only visible to org members.",
1488
+ inputSchema: toZod({
1489
+ "type": "object",
1490
+ "properties": {
1491
+ "params": {
1492
+ "type": "object",
1493
+ "properties": {
1494
+
1495
+ }
1496
+ },
1497
+ "query": {
1498
+ "type": "object",
1499
+ "properties": {
1500
+ "q": {
1501
+ "type": "string",
1502
+ "minLength": 1,
1503
+ "maxLength": 200
1504
+ },
1505
+ "tag": {
1506
+ "type": "array",
1507
+ "maxItems": 20,
1508
+ "items": {
1509
+ "type": "string",
1510
+ "description": "A free-form label attached to an entity for grouping and filtering in listings. Must start and end with an alphanumeric character; only ASCII letters, digits, spaces, and hyphens are allowed between.",
1511
+ "pattern": "^[A-Za-z0-9]([A-Za-z0-9 \\-]*[A-Za-z0-9])?$",
1512
+ "minLength": 1,
1513
+ "maxLength": 50
1514
+ }
1515
+ },
1516
+ "cursor": {
1517
+ "type": "string",
1518
+ "maxLength": 500
1519
+ }
1520
+ }
1521
+ },
1522
+ "body": {
1523
+ "type": "object"
1524
+ }
1525
+ },
1526
+ "required": [
1527
+ "params",
1528
+ "query"
1529
+ ],
1530
+ "additionalProperties": false
1531
+ }),
1532
+ },
1533
+ "PublishProviderVersion": {
1534
+ description: "Publish a draft version directly (PRIVATE providers only)\n\nPublishes a verification version on the `draft` branch directly to the live channel (trunk). Only allowed for PRIVATE providers — PUBLIC providers must use the review flow (`POST .../review` → admin decision). On success the version's branch transitions from `draft` to `null` (trunk/live).",
1535
+ inputSchema: toZod({
1536
+ "type": "object",
1537
+ "properties": {
1538
+ "params": {
1539
+ "type": "object",
1540
+ "properties": {
1541
+ "providerId": {
1542
+ "type": "string",
1543
+ "format": "uuid"
1544
+ },
1545
+ "version": {
1546
+ "type": "string",
1547
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
1548
+ "maxLength": 32
1549
+ }
1550
+ },
1551
+ "required": [
1552
+ "providerId",
1553
+ "version"
1554
+ ],
1555
+ "additionalProperties": false
1556
+ },
1557
+ "query": {
1558
+ "type": "object",
1559
+ "properties": {
1560
+
1561
+ }
1562
+ },
1563
+ "body": {
1564
+ "type": "object",
1565
+ "additionalProperties": false,
1566
+ "description": "Body for publishing a draft version directly to the live channel. Only allowed for PRIVATE providers.",
1567
+ "properties": {
1568
+ "notes": {
1569
+ "type": "string",
1570
+ "description": "Optional publish note.",
1571
+ "maxLength": 10000
1572
+ }
1573
+ }
1574
+ }
1575
+ },
1576
+ "required": [
1577
+ "params",
1578
+ "query",
1579
+ "body"
1580
+ ],
1581
+ "additionalProperties": false
1582
+ }),
1583
+ },
1584
+ "RequestPublicListing": {
1585
+ description: "Request public listing for a PRIVATE provider\n\nSubmits a PRIVATE provider's latest trunk version for admin review. When approved, the provider's visibility becomes PUBLIC and all future versions require review before going live. Fails if the provider is already PUBLIC or has no live versions.",
1586
+ inputSchema: toZod({
1587
+ "type": "object",
1588
+ "properties": {
1589
+ "params": {
1590
+ "type": "object",
1591
+ "properties": {
1592
+ "providerId": {
1593
+ "type": "string",
1594
+ "format": "uuid"
1595
+ }
1596
+ },
1597
+ "required": [
1598
+ "providerId"
1599
+ ],
1600
+ "additionalProperties": false
1601
+ },
1602
+ "query": {
1603
+ "type": "object",
1604
+ "properties": {
1605
+
1606
+ }
1607
+ },
1608
+ "body": {
1609
+ "type": "object",
1610
+ "additionalProperties": false,
1611
+ "description": "Body for visibility change requests (request public listing or make private).",
1612
+ "properties": {
1613
+ "notes": {
1614
+ "type": "string",
1615
+ "description": "Optional note explaining the change.",
1616
+ "maxLength": 10000
1617
+ }
1618
+ }
1619
+ }
1620
+ },
1621
+ "required": [
1622
+ "params",
1623
+ "query",
1624
+ "body"
1625
+ ],
1626
+ "additionalProperties": false
1627
+ }),
1628
+ },
1629
+ "RevokeCredential": {
1630
+ description: "Revoke a credential\n\nSoft-revokes the credential (sets `revokedAt`). Allowed for the creating user (anonymous credentials), an active OWNER of the owning org (linked credentials), or a Reclaim admin. Revoked credentials cannot be used for verification and cannot be re-linked.",
1631
+ inputSchema: toZod({
1632
+ "type": "object",
1633
+ "properties": {
1634
+ "params": {
1635
+ "type": "object",
1636
+ "properties": {
1637
+ "credentialId": {
1638
+ "type": "string",
1639
+ "format": "uuid",
1640
+ "description": "Stable id for a `Credential` row."
1641
+ }
1642
+ },
1643
+ "required": [
1644
+ "credentialId"
1645
+ ],
1646
+ "additionalProperties": false
1647
+ },
1648
+ "query": {
1649
+ "type": "object",
1650
+ "properties": {
1651
+
1652
+ }
1653
+ },
1654
+ "body": {
1655
+ "type": "object"
1656
+ }
1657
+ },
1658
+ "required": [
1659
+ "params",
1660
+ "query"
1661
+ ],
1662
+ "additionalProperties": false
1663
+ }),
1664
+ },
1665
+ "SubmitProviderVersionForReview": {
1666
+ description: "Submit a verification version for review\n\nSubmits a verification version (currently on the `draft` or `rejected` branch) for admin review. On success the version's branch transitions to `in_review`. Callable by any authenticated member of the verification's owning org. Meaningful only on `PUBLIC` verifications — on `PRIVATE` verifications new versions go to the live channel directly and never need review.",
1667
+ inputSchema: toZod({
1668
+ "type": "object",
1669
+ "properties": {
1670
+ "params": {
1671
+ "type": "object",
1672
+ "properties": {
1673
+ "providerId": {
1674
+ "type": "string",
1675
+ "format": "uuid"
1676
+ },
1677
+ "version": {
1678
+ "type": "string",
1679
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
1680
+ "maxLength": 32
1681
+ }
1682
+ },
1683
+ "required": [
1684
+ "providerId",
1685
+ "version"
1686
+ ],
1687
+ "additionalProperties": false
1688
+ },
1689
+ "query": {
1690
+ "type": "object",
1691
+ "properties": {
1692
+
1693
+ }
1694
+ },
1695
+ "body": {
1696
+ "type": "object",
1697
+ "additionalProperties": false,
1698
+ "description": "Body for submitting a provider version for review. Transitions the version's branch from `draft` (or `rejected`) to `in_review`.",
1699
+ "properties": {
1700
+ "notes": {
1701
+ "type": "string",
1702
+ "description": "Optional note from the author to reviewers (changelog, areas to focus on, etc.).",
1703
+ "maxLength": 10000
1704
+ }
1705
+ }
1706
+ }
1707
+ },
1708
+ "required": [
1709
+ "params",
1710
+ "query",
1711
+ "body"
1712
+ ],
1713
+ "additionalProperties": false
1714
+ }),
1715
+ },
1716
+ "TransferProvider": {
1717
+ description: "Transfer a verification to a different workspace\n\nAdmin-only. Moves the verification's `orgId` to the supplied workspace; preserves slug, versions, members. SQL function `builder.transfer_provider` enforces the admin gate and target existence atomically.",
1718
+ inputSchema: toZod({
1719
+ "type": "object",
1720
+ "properties": {
1721
+ "params": {
1722
+ "type": "object",
1723
+ "properties": {
1724
+ "providerId": {
1725
+ "type": "string",
1726
+ "format": "uuid"
1727
+ }
1728
+ },
1729
+ "required": [
1730
+ "providerId"
1731
+ ],
1732
+ "additionalProperties": false
1733
+ },
1734
+ "query": {
1735
+ "type": "object",
1736
+ "properties": {
1737
+
1738
+ }
1739
+ },
1740
+ "body": {
1741
+ "type": "object",
1742
+ "additionalProperties": false,
1743
+ "required": [
1744
+ "orgId"
1745
+ ],
1746
+ "properties": {
1747
+ "orgId": {
1748
+ "type": "string",
1749
+ "format": "uuid"
1750
+ }
1751
+ }
1752
+ }
1753
+ },
1754
+ "required": [
1755
+ "params",
1756
+ "query",
1757
+ "body"
1758
+ ],
1759
+ "additionalProperties": false
1760
+ }),
1761
+ },
1762
+ "UpdateMe": {
1763
+ description: "Update the authenticated user's profile",
1764
+ inputSchema: toZod({
1765
+ "type": "object",
1766
+ "properties": {
1767
+ "params": {
1768
+ "type": "object",
1769
+ "properties": {
1770
+
1771
+ }
1772
+ },
1773
+ "query": {
1774
+ "type": "object",
1775
+ "properties": {
1776
+
1777
+ }
1778
+ },
1779
+ "body": {
1780
+ "type": "object",
1781
+ "additionalProperties": false,
1782
+ "description": "Caller-editable fields on the authenticated user.",
1783
+ "properties": {
1784
+ "name": {
1785
+ "type": "string",
1786
+ "minLength": 1,
1787
+ "maxLength": 200
1788
+ }
1789
+ }
1790
+ }
1791
+ },
1792
+ "required": [
1793
+ "params",
1794
+ "query",
1795
+ "body"
1796
+ ],
1797
+ "additionalProperties": false
1798
+ }),
1799
+ },
1800
+ "UpdateOrg": {
1801
+ description: "Update an organization\n\nOwner only.",
1802
+ inputSchema: toZod({
1803
+ "type": "object",
1804
+ "properties": {
1805
+ "params": {
1806
+ "type": "object",
1807
+ "properties": {
1808
+ "orgId": {
1809
+ "type": "string",
1810
+ "format": "uuid"
1811
+ }
1812
+ },
1813
+ "required": [
1814
+ "orgId"
1815
+ ],
1816
+ "additionalProperties": false
1817
+ },
1818
+ "query": {
1819
+ "type": "object",
1820
+ "properties": {
1821
+
1822
+ }
1823
+ },
1824
+ "body": {
1825
+ "type": "object",
1826
+ "additionalProperties": false,
1827
+ "properties": {
1828
+ "name": {
1829
+ "type": "string",
1830
+ "minLength": 1,
1831
+ "maxLength": 200
1832
+ },
1833
+ "status": {
1834
+ "type": "string",
1835
+ "description": "The status of the entity.\n\n- `ACTIVE`: The entity is active.\n\n- `ARCHIVED`: The entity is archived.",
1836
+ "enum": [
1837
+ "ACTIVE",
1838
+ "ARCHIVED"
1839
+ ]
1840
+ },
1841
+ "iconUrl": {
1842
+ "type": "string",
1843
+ "format": "uri",
1844
+ "description": "Replace the org avatar URL directly. Most clients upload via `PUT /orgs/{orgId}/icon` and let the server write this field.",
1845
+ "maxLength": 2000
1846
+ }
1847
+ }
1848
+ }
1849
+ },
1850
+ "required": [
1851
+ "params",
1852
+ "query",
1853
+ "body"
1854
+ ],
1855
+ "additionalProperties": false
1856
+ }),
1857
+ },
1858
+ "UpdateOrgBilling": {
1859
+ description: "Add or update billing details for an organization\n\nOwner only. Upserts the billing row. The first successful call flips every credential linked to this org from `SANDBOX` to `PRODUCTION` (see `Credential.mode`). Subsequent calls update the contact fields without affecting credential mode.",
1860
+ inputSchema: toZod({
1861
+ "type": "object",
1862
+ "properties": {
1863
+ "params": {
1864
+ "type": "object",
1865
+ "properties": {
1866
+ "orgId": {
1867
+ "type": "string",
1868
+ "format": "uuid"
1869
+ }
1870
+ },
1871
+ "required": [
1872
+ "orgId"
1873
+ ],
1874
+ "additionalProperties": false
1875
+ },
1876
+ "query": {
1877
+ "type": "object",
1878
+ "properties": {
1879
+
1880
+ }
1881
+ },
1882
+ "body": {
1883
+ "type": "object",
1884
+ "additionalProperties": false,
1885
+ "description": "Body for `PUT /orgs/{orgId}/billing`.",
1886
+ "required": [
1887
+ "contactEmail",
1888
+ "contactName"
1889
+ ],
1890
+ "properties": {
1891
+ "contactEmail": {
1892
+ "type": "string",
1893
+ "format": "email",
1894
+ "minLength": 3,
1895
+ "maxLength": 320
1896
+ },
1897
+ "contactName": {
1898
+ "type": "string",
1899
+ "minLength": 1,
1900
+ "maxLength": 200
1901
+ }
1902
+ }
1903
+ }
1904
+ },
1905
+ "required": [
1906
+ "params",
1907
+ "query",
1908
+ "body"
1909
+ ],
1910
+ "additionalProperties": false
1911
+ }),
1912
+ },
1913
+ "UpdateProvider": {
1914
+ description: "Update a verification\n\nUpdate a Reclaim verification's metadata. Partial PATCH — pass only fields you want to change. The caller must be an active member of the owning organization. To change the verification's recipe (initialUrl, requests, …) cut a new version via the dashboard. Use `seo` to control how the verification appears in search results and social shares; omit a subfield to keep the server default.\nCaller must be a member of the verification's owning organization. `id`, `orgId`, and `slug` are immutable. Supports optimistic concurrency via `If-Match`.",
1915
+ inputSchema: toZod({
1916
+ "type": "object",
1917
+ "properties": {
1918
+ "params": {
1919
+ "type": "object",
1920
+ "properties": {
1921
+ "providerId": {
1922
+ "type": "string",
1923
+ "format": "uuid"
1924
+ }
1925
+ },
1926
+ "required": [
1927
+ "providerId"
1928
+ ],
1929
+ "additionalProperties": false
1930
+ },
1931
+ "query": {
1932
+ "type": "object",
1933
+ "properties": {
1934
+
1935
+ }
1936
+ },
1937
+ "headers": {
1938
+ "type": "object",
1939
+ "properties": {
1940
+ "If-Match": {
1941
+ "type": "string",
1942
+ "maxLength": 128,
1943
+ "description": "Opaque `ETag` from a prior GET on the same resource. When\nsupplied, the server applies optimistic concurrency: the\nmutation fails with `412 Precondition Failed` if the\nresource has been modified since. Omit for last-write-wins.\n"
1944
+ }
1945
+ }
1946
+ },
1947
+ "body": {
1948
+ "type": "object",
1949
+ "additionalProperties": false,
1950
+ "description": "Partial update of an existing provider. Immutable fields (`id`, `orgId`, `slug`) are not accepted here.",
1951
+ "properties": {
1952
+ "domain": {
1953
+ "type": "string",
1954
+ "format": "hostname",
1955
+ "minLength": 1,
1956
+ "maxLength": 200
1957
+ },
1958
+ "title": {
1959
+ "type": "string",
1960
+ "minLength": 1,
1961
+ "maxLength": 100
1962
+ },
1963
+ "description": {
1964
+ "type": "string",
1965
+ "minLength": 1,
1966
+ "maxLength": 2000
1967
+ },
1968
+ "iconUrl": {
1969
+ "description": "uri of the icon",
1970
+ "type": "string",
1971
+ "format": "uri",
1972
+ "maxLength": 2000
1973
+ },
1974
+ "visibility": {
1975
+ "type": "string",
1976
+ "description": "The visibility of the entity.\n\n- `PRIVATE`: Only the owner can see the entity.\n\n- `PUBLIC`: Anyone can see the entity.",
1977
+ "enum": [
1978
+ "PRIVATE",
1979
+ "PUBLIC"
1980
+ ]
1981
+ },
1982
+ "status": {
1983
+ "type": "string",
1984
+ "description": "The status of the entity.\n\n- `ACTIVE`: The entity is active.\n\n- `ARCHIVED`: The entity is archived.",
1985
+ "enum": [
1986
+ "ACTIVE",
1987
+ "ARCHIVED"
1988
+ ]
1989
+ },
1990
+ "tags": {
1991
+ "type": "array",
1992
+ "maxItems": 50,
1993
+ "uniqueItems": true,
1994
+ "items": {
1995
+ "type": "string",
1996
+ "description": "A free-form label attached to an entity for grouping and filtering in listings. Must start and end with an alphanumeric character; only ASCII letters, digits, spaces, and hyphens are allowed between.",
1997
+ "pattern": "^[A-Za-z0-9]([A-Za-z0-9 \\-]*[A-Za-z0-9])?$",
1998
+ "minLength": 1,
1999
+ "maxLength": 50
2000
+ }
2001
+ },
2002
+ "seo": {
2003
+ "type": "object",
2004
+ "additionalProperties": false,
2005
+ "description": "Author-set SEO fields. All optional.\n\nEach field is paired with a server-derived default of the\nsame name on `Provider.seoSuggestions`. Renderers pick the\neffective value per field:\n\n effective.<field> = seo.<field> ?? seoSuggestions.<field>\n\nSet a field here to override; leave it unset to let the\ndefault win. Both objects are returned on every\n`GET /providers/{id}` — the builder does not pre-merge.\n",
2006
+ "properties": {
2007
+ "brandUrl": {
2008
+ "type": "string",
2009
+ "format": "uri",
2010
+ "description": "Canonical homepage of the brand (e.g. `https://google.com`). Used in brand-link cards and JSON-LD.",
2011
+ "maxLength": 2000
2012
+ },
2013
+ "primaryDataPoint": {
2014
+ "type": "string",
2015
+ "description": "Headline data point — the single most-important variable this provider can verify (e.g. `subscriber count`). Used in the provider's SEO title.",
2016
+ "maxLength": 200
2017
+ },
2018
+ "dataPoints": {
2019
+ "type": "array",
2020
+ "description": "Full list of data points this provider can verify.",
2021
+ "maxItems": 50,
2022
+ "items": {
2023
+ "type": "string",
2024
+ "maxLength": 200
2025
+ }
2026
+ },
2027
+ "titleOverride": {
2028
+ "type": "string",
2029
+ "description": "Replaces the renderer's composed `<title>` / OG title. Use when the default composition reads awkwardly.",
2030
+ "maxLength": 200
2031
+ },
2032
+ "descriptionOverride": {
2033
+ "type": "string",
2034
+ "description": "Replaces the renderer's composed `<meta name=\"description\">` / OG description.",
2035
+ "maxLength": 320
2036
+ }
2037
+ }
2038
+ }
2039
+ }
2040
+ }
2041
+ },
2042
+ "required": [
2043
+ "params",
2044
+ "query",
2045
+ "body"
2046
+ ],
2047
+ "additionalProperties": false
2048
+ }),
2049
+ },
2050
+ "UpdateProviderVersion": {
2051
+ description: "Update a verification version\n\nMutable only while the version is on the `draft` or `rejected` branch. Versions on `in_review` or the live channel reject all writes here. Caller must be a member of the verification's owning organization. Supports optimistic concurrency via `If-Match`.",
2052
+ inputSchema: toZod({
2053
+ "type": "object",
2054
+ "properties": {
2055
+ "params": {
2056
+ "type": "object",
2057
+ "properties": {
2058
+ "providerId": {
2059
+ "type": "string",
2060
+ "format": "uuid"
2061
+ },
2062
+ "version": {
2063
+ "type": "string",
2064
+ "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-zA-Z0-9_-]+(?:\\.[0-9]+)?)?$",
2065
+ "maxLength": 32
2066
+ }
2067
+ },
2068
+ "required": [
2069
+ "providerId",
2070
+ "version"
2071
+ ],
2072
+ "additionalProperties": false
2073
+ },
2074
+ "query": {
2075
+ "type": "object",
2076
+ "properties": {
2077
+
2078
+ }
2079
+ },
2080
+ "headers": {
2081
+ "type": "object",
2082
+ "properties": {
2083
+ "If-Match": {
2084
+ "type": "string",
2085
+ "maxLength": 128,
2086
+ "description": "Opaque `ETag` from a prior GET on the same resource. When\nsupplied, the server applies optimistic concurrency: the\nmutation fails with `412 Precondition Failed` if the\nresource has been modified since. Omit for last-write-wins.\n"
2087
+ }
2088
+ }
2089
+ },
2090
+ "body": {
2091
+ "type": "object",
2092
+ "additionalProperties": false,
2093
+ "description": "Partial update of a provider version. Mutable only while the version is on the `draft` or `rejected` branch; versions on `in_review` or the live channel reject all writes here. The semver does not change on update — `build_number` increments instead, giving callers a monotonic revision counter without touching the (major, minor, patch) PK. `verificationType` / `prompt` are not accepted; see `ProviderVersion` for why.",
2094
+ "properties": {
2095
+ "initialUrl": {
2096
+ "type": "string",
2097
+ "format": "uri",
2098
+ "maxLength": 300
2099
+ },
2100
+ "requests": {
2101
+ "type": "array",
2102
+ "minItems": 0,
2103
+ "items": {
2104
+ "type": "object",
2105
+ "additionalProperties": false,
2106
+ "description": "A matcher for one HTTP request in observed traffic, together with the response constraints that must hold for a Reclaim proof over that request to be valid. Used by interceptors, in-page injections, and LLM agents.",
2107
+ "required": [
2108
+ "url",
2109
+ "method"
2110
+ ],
2111
+ "properties": {
2112
+ "url": {
2113
+ "type": "string",
2114
+ "description": "The URL or generic path of the HTTP request."
2115
+ },
2116
+ "method": {
2117
+ "type": "string",
2118
+ "description": "The HTTP method used for the request.",
2119
+ "enum": [
2120
+ "GET",
2121
+ "POST",
2122
+ "PUT",
2123
+ "PATCH",
2124
+ "DELETE"
2125
+ ]
2126
+ },
2127
+ "requestBodyTemplate": {
2128
+ "type": "string",
2129
+ "description": "Template used to match or capture an outgoing request body. Template can use regex templates as placeholders. For example, to match an outgoing request body that contains a request ID, you can use the following template: `(?<requestId>.*)`.",
2130
+ "maxLength": 100000
2131
+ },
2132
+ "credentials": {
2133
+ "type": "string",
2134
+ "description": "Mirrors the Fetch API `RequestCredentials` value used when issuing the request — controls whether cookies and auth headers are sent.",
2135
+ "enum": [
2136
+ "omit",
2137
+ "same-origin",
2138
+ "include"
2139
+ ]
2140
+ },
2141
+ "writeRedactionMode": {
2142
+ "type": "string",
2143
+ "description": "How the matched portion of the response should be redacted before the transcript is handed to the attestor.\n- `zk`: redact using a zero-knowledge proof over the original\n bytes.\n\n- `key-update`: redact by performing a TLS key update so the\n attestor never observes the matched bytes in cleartext.",
2144
+ "enum": [
2145
+ "zk",
2146
+ "key-update"
2147
+ ]
2148
+ },
2149
+ "additionalClientOptions": {
2150
+ "type": "object",
2151
+ "additionalProperties": false,
2152
+ "description": "Apply TLS configuration when creating the tunnel to the attestor.",
2153
+ "properties": {
2154
+ "supportedProtocolVersions": {
2155
+ "type": "array",
2156
+ "description": "TLS protocol versions the client is allowed to negotiate.",
2157
+ "minItems": 1,
2158
+ "uniqueItems": true,
2159
+ "items": {
2160
+ "type": "string",
2161
+ "enum": [
2162
+ "TLS1_2",
2163
+ "TLS1_3"
2164
+ ]
2165
+ }
2166
+ }
2167
+ }
2168
+ },
2169
+ "matches": {
2170
+ "type": "array",
2171
+ "description": "A list of match conditions for the response.",
2172
+ "minItems": 1,
2173
+ "items": {
2174
+ "type": "object",
2175
+ "additionalProperties": false,
2176
+ "description": "Specifies a rule to match against a string in response to validate proof content.",
2177
+ "required": [
2178
+ "type",
2179
+ "value"
2180
+ ],
2181
+ "properties": {
2182
+ "isOptional": {
2183
+ "type": "boolean",
2184
+ "description": "If true, the match condition is optional and won't fail if absent",
2185
+ "default": false
2186
+ },
2187
+ "description": {
2188
+ "type": "string",
2189
+ "description": "The description of the field that is extracted using this match rule",
2190
+ "minLength": 1,
2191
+ "maxLength": 1000
2192
+ },
2193
+ "order": {
2194
+ "type": "integer",
2195
+ "description": "The order in which the field should be displayed to user in UI",
2196
+ "minimum": 0
2197
+ },
2198
+ "type": {
2199
+ "type": "string",
2200
+ "description": "The matching mechanism to use value as against response. Typically regex or simple string containment",
2201
+ "enum": [
2202
+ "regex",
2203
+ "contains"
2204
+ ]
2205
+ },
2206
+ "value": {
2207
+ "type": "string",
2208
+ "description": "The pattern or value to look for in the response. When `type` is 'contains', supports template variable declaration using `{{variable}}` syntax. When `type` is 'regex', can be used to extract variables using regex named groups."
2209
+ },
2210
+ "extract": {
2211
+ "type": "object",
2212
+ "description": "Which portions to select from a response. These are selected in order, xpath => jsonPath => regex * These redactions are done client side and only the selected portions are sent to the attestor. The attestor will only be able to see the selected portions alongside the first line of the HTTP response (i.e. \"HTTP/1.1 200 OK\")",
2213
+ "properties": {
2214
+ "xPath": {
2215
+ "type": "string",
2216
+ "description": "expect an HTML response, and to contain a certain xpath for eg. \"/html/body/div.a1/div.a2/span.a5\""
2217
+ },
2218
+ "jsonPath": {
2219
+ "type": "string",
2220
+ "description": "expect a JSON response, retrieve the item at this path using dot notation for e.g. 'email.addresses.0'"
2221
+ },
2222
+ "regex": {
2223
+ "type": "string",
2224
+ "description": "select a regex match from the response"
2225
+ },
2226
+ "hash": {
2227
+ "type": "string",
2228
+ "description": "If provided, the value inside will be hashed instead of being redacted. Useful for cases where the data inside is an identifiying piece of information that you don't want to reveal to the attestor, eg. an email address.\nIf the hash function produces more bytes than the original value, the hash will be truncated.\nEg. if hash is enabled, the original value is \"hello\", and hashed is \"a1b2c\", then the attestor will only see \"a1b2c\".\nNote: if a regex with named groups is provided, only the named groups will be hashed.",
2229
+ "enum": [
2230
+ "oprf",
2231
+ "oprf-mpc",
2232
+ "oprf-raw"
2233
+ ]
2234
+ }
2235
+ }
2236
+ }
2237
+ }
2238
+ }
2239
+ }
2240
+ }
2241
+ }
2242
+ },
2243
+ "allowedJsRequests": {
2244
+ "type": "array",
2245
+ "minItems": 0,
2246
+ "items": {
2247
+ "type": "object",
2248
+ "additionalProperties": false,
2249
+ "description": "A template for selecting request",
2250
+ "allOf": [
2251
+ {
2252
+ "$ref": "#/components/schemas/RequestSelection"
2253
+ },
2254
+ {
2255
+ "type": "object",
2256
+ "required": [
2257
+ "multiple",
2258
+ "required"
2259
+ ],
2260
+ "properties": {
2261
+ "multiple": {
2262
+ "type": "boolean",
2263
+ "description": "If true, the template is allowed for multiple requests. Useful for requests like paginated API calls.",
2264
+ "default": true
2265
+ },
2266
+ "required": {
2267
+ "type": "boolean",
2268
+ "description": "If true, a request is required to match with this template. If not requests matches this template in proof, then validation fails.",
2269
+ "default": true
2270
+ }
2271
+ }
2272
+ }
2273
+ ]
2274
+ }
2275
+ },
2276
+ "webSettings": {
2277
+ "type": "object",
2278
+ "additionalProperties": false,
2279
+ "description": "Settings used by the web-based verification client.",
2280
+ "properties": {
2281
+ "geoLocation": {
2282
+ "type": "string",
2283
+ "description": "Geographic location (e.g. ISO country code or {{DYNAMIC_GEO}} to use user's geo location) the verification should appear to originate from.",
2284
+ "maxLength": 15
2285
+ },
2286
+ "clientOptions": {
2287
+ "type": "object",
2288
+ "additionalProperties": false,
2289
+ "description": "Options that influence how the web verification client behaves.",
2290
+ "properties": {
2291
+ "portal": {
2292
+ "type": "object",
2293
+ "additionalProperties": false,
2294
+ "description": "Options that influence how the portal verification client behaves.",
2295
+ "properties": {
2296
+ "useProxy": {
2297
+ "type": "boolean",
2298
+ "description": "When true, network traffic from the portal client and attestation is routed through a proxy.",
2299
+ "default": false
2300
+ },
2301
+ "userAgent": {
2302
+ "type": "string",
2303
+ "description": "User-agent string used for platform verification.",
2304
+ "maxLength": 500
2305
+ }
2306
+ }
2307
+ },
2308
+ "inapp": {
2309
+ "type": "object",
2310
+ "additionalProperties": false,
2311
+ "description": "Options that influence how the in-app verification client behaves.",
2312
+ "properties": {
2313
+ "interceptorOptions": {
2314
+ "type": "object",
2315
+ "additionalProperties": false,
2316
+ "required": [
2317
+ "interceptorType"
2318
+ ],
2319
+ "properties": {
2320
+ "interceptorType": {
2321
+ "type": "string",
2322
+ "description": "How traffic interception is implemented.",
2323
+ "enum": [
2324
+ "HAWKEYE",
2325
+ "MSWJS",
2326
+ "CDP"
2327
+ ]
2328
+ },
2329
+ "isDocumentRequestReplayEnabled": {
2330
+ "type": "boolean",
2331
+ "description": "Whether the main document request is replayed via the attestor",
2332
+ "default": false
2333
+ },
2334
+ "interceptorSettings": {
2335
+ "type": "string",
2336
+ "description": "Free-form configuration passed through to the interceptor implementation selected by `interceptorType`. Keys and value shapes are defined by the chosen interceptor.",
2337
+ "contentMediaType": "application/json"
2338
+ }
2339
+ }
2340
+ },
2341
+ "userAgents": {
2342
+ "type": "object",
2343
+ "additionalProperties": false,
2344
+ "description": "User-agent strings keyed by platform.",
2345
+ "properties": {
2346
+ "android": {
2347
+ "type": "string",
2348
+ "description": "User-agent string used for platform verification.",
2349
+ "maxLength": 500
2350
+ },
2351
+ "ios": {
2352
+ "type": "string",
2353
+ "description": "User-agent string used for platform verification.",
2354
+ "maxLength": 500
2355
+ }
2356
+ }
2357
+ }
2358
+ }
2359
+ }
2360
+ }
2361
+ },
2362
+ "jsUserScripts": {
2363
+ "type": "string",
2364
+ "description": "JavaScript snippets injected into the page which runs before every page load. `window.Reclaim.` APIs are available to these scripts to request actions to the client like claim creation.",
2365
+ "maxLength": 1000000
2366
+ }
2367
+ }
2368
+ },
2369
+ "requiredParameters": {
2370
+ "type": "object",
2371
+ "description": "Map of parameter names needed (optional or required) to use this provider to their human-readable descriptions/labels. Values are plain strings shown alongside the field in dashboards and prompts.",
2372
+ "maxProperties": 50,
2373
+ "additionalProperties": {
2374
+ "type": "string",
2375
+ "maxLength": 500
2376
+ }
2377
+ },
2378
+ "notes": {
2379
+ "type": "string",
2380
+ "description": "Free-form change note recorded on `updateMetadata`.",
2381
+ "maxLength": 10000
2382
+ }
2383
+ }
2384
+ }
2385
+ },
2386
+ "required": [
2387
+ "params",
2388
+ "query",
2389
+ "body"
2390
+ ],
2391
+ "additionalProperties": false
2392
+ }),
2393
+ },
2394
+ }
2395
+
2396
+ export type McpToolName = keyof typeof MCP_TOOLS
2397
+ export type McpToolShape = (typeof MCP_TOOLS)[McpToolName]