@workos/mcp-docs-server 0.1.0 → 0.2.0

package/.docs/organized/docs/reference/mfa/{challenge-factor.mdx → challenge/create.mdx}

@@ -157,7 +157,7 @@ reference:
           type: mfa.Challenge
           description: (authentication_challenge.self)
         - (err)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/challenge-factor.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/challenge/create.mdx
 ---
 
 ## Challenge Factor

package/.docs/organized/docs/reference/mfa/{authentication-challenge.mdx → challenge/index.mdx}

@@ -1,9 +1,7 @@
 ---
 descriptions:
   authentication_challenge:
-    self: >-
-      The [Authentication Challenge](/reference/mfa/authentication-challenge)
-      object.
+    self: 'The [Authentication Challenge](/reference/mfa/challenge) object.'
     object: Distinguishes the Authentication Challenge object.
     id: The unique ID of the Authentication Challenge.
     created_at: The timestamp when the Challenge was created.
@@ -14,7 +12,7 @@ descriptions:
     authentication_factor_id: The unique ID of the Authentication Factor the Challenge belongs to.
 reference:
   curl:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: authentication_challenge
       id: authentication_challenge
       title: authentication_challenge
@@ -38,7 +36,7 @@ reference:
           type: string
           description: (authentication_challenge.authentication_factor_id)
   dotnet:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: Challenge
       id: authentication_challenge
       title: class Challenge
@@ -62,7 +60,7 @@ reference:
           type: string
           description: (authentication_challenge.authentication_factor_id)
   ruby:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: Challenge
       id: authentication_challenge
       title: class Challenge
@@ -86,7 +84,7 @@ reference:
           type: String
           description: (authentication_challenge.authentication_factor_id)
   python:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: AuthenticationChallenge
       id: authentication_challenge
       title: AuthenticationChallenge
@@ -110,7 +108,7 @@ reference:
           type: str
           description: (authentication_challenge.authentication_factor_id)
   js:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: Challenge
       id: authentication_challenge
       title: interface Challenge
@@ -134,7 +132,7 @@ reference:
           type: string
           description: (authentication_challenge.authentication_factor_id)
   php:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: AuthenticationChallenge
       id: authentication_challenge
       title: WorkOS\Resource\AuthenticationChallenge
@@ -158,7 +156,7 @@ reference:
           type: string
           description: (authentication_challenge.authentication_factor_id)
   java:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: Challenge
       id: authentication_challenge
       title: class Challenge
@@ -182,7 +180,7 @@ reference:
           type: String
           description: (authentication_challenge.authentication_factor_id)
   go:
-    - url: /reference/mfa/authentication-challenge
+    - url: /reference/mfa/challenge
       key: Challenge
       id: authentication_challenge
       title: mfa.Challenge
@@ -202,11 +200,10 @@ reference:
         - key: FactorID
           type: string
           description: (authentication_challenge.authentication_factor_id)
-originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/mfa/authentication-challenge.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/challenge/index.mdx
 ---
 
-## Authentication Challenge
+# Authentication Challenge
 
 An object representing a Challenge of an Authentication Factor.
 

package/.docs/organized/docs/reference/mfa/{verify-challenge.mdx → challenge/verify.mdx}

@@ -3,15 +3,13 @@ descriptions:
   verify_challenge:
     authentication_challenge_id: The unique ID of the authentication Challenge.
     code: The 6 digit code to be verified.
-    challenge: >-
-      The relevant [Authentication
-      Challenge](/reference/mfa/authentication-challenge).
+    challenge: 'The relevant [Authentication Challenge](/reference/mfa/challenge).'
     valid: Indicates whether the code was correct.
 reference:
   curl:
     - key: verify_challenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: '/auth/challenges/:id/verify'
       type: POST
       parameters:
@@ -35,7 +33,7 @@ reference:
   dotnet:
     - key: VerifyChallenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: mfaService.VerifyChallenge()
       parameters:
         - key: options
@@ -63,7 +61,7 @@ reference:
   ruby:
     - key: verify_challenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: MFA.verify_challenge()
       parameters:
         - key: authentication_challenge_id
@@ -86,7 +84,7 @@ reference:
   python:
     - key: verify_challenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: mfa.verify_challenge()
       parameters:
         - key: authentication_challenge_id
@@ -109,7 +107,7 @@ reference:
   js:
     - key: verifyChallenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: mfa.verifyChallenge()
       parameters:
         - key: options
@@ -136,7 +134,7 @@ reference:
   php:
     - key: verifyChallenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: $mfa->verifyChallenge()
       parameters:
         - key: authenticationChallengeId
@@ -159,7 +157,7 @@ reference:
   java:
     - key: verifyChallenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: mfa.verifyChallenge()
       parameters:
         - key: options
@@ -189,7 +187,7 @@ reference:
   go:
     - key: VerifyChallenge
       id: verify_challenge
-      url: /reference/mfa/verify-challenge
+      url: /reference/mfa/challenge/verify
       title: mfa.VerifyChallenge()
       parameters:
         - (ctx)
@@ -215,7 +213,7 @@ reference:
               type: bool
               description: (verify_challenge.valid)
         - (err)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/verify-challenge.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/challenge/verify.mdx
 ---
 
 ## Verify Challenge

package/.docs/organized/docs/reference/mfa/{delete-factor.mdx → factor/delete.mdx}

@@ -79,7 +79,7 @@ reference:
               description: (authentication_factor.id)
       returns:
         - (err)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/delete-factor.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/factor/delete.mdx
 ---
 
 ## Delete Factor

package/.docs/organized/docs/reference/mfa/{enroll-factor.mdx → factor/enroll.mdx}

@@ -228,7 +228,7 @@ reference:
           type: mfa.Factor
           description: (authentication_factor.self)
         - (err)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/enroll-factor.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/factor/enroll.mdx
 ---
 
 ## Enroll Factor

package/.docs/organized/docs/reference/mfa/{get-factor.mdx → factor/get.mdx}

@@ -95,7 +95,7 @@ reference:
           type: mfa.Factor
           description: (authentication_factor.self)
         - (err)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/get-factor.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/factor/get.mdx
 ---
 
 ## Get Factor

package/.docs/organized/docs/reference/mfa/{authentication-factor.mdx → factor/index.mdx}

@@ -1,7 +1,7 @@
 ---
 descriptions:
   authentication_factor:
-    self: 'The [Authentication Factor](/reference/mfa/authentication-factor) object.'
+    self: 'The [Authentication Factor](/reference/mfa/factor) object.'
     object: Distinguishes the Authentication Factor object.
     id: The unique ID of the Factor.
     created_at: The timestamp when the Factor was created.
@@ -17,7 +17,7 @@ descriptions:
     sms_phone_number: Phone number that the Factor was enrolled with.
 reference:
   curl:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: authentication_factor
       id: authentication_factor
       title: authentication_factor
@@ -61,7 +61,7 @@ reference:
               type: string
               description: (authentication_factor.sms_phone_number)
   dotnet:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: Factor
       id: authentication_factor
       title: class Factor
@@ -105,7 +105,7 @@ reference:
               type: string
               description: (authentication_factor.sms_phone_number)
   ruby:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: Factor
       id: authentication_factor
       title: class Factor
@@ -149,7 +149,7 @@ reference:
               type: String
               description: (authentication_factor.sms_phone_number)
   python:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: AuthenticationFactor
       id: authentication_factor
       title: AuthenticationFactor
@@ -192,7 +192,7 @@ reference:
               type: str
               description: (authentication_factor.sms_phone_number)
   js:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: Factor
       id: authentication_factor
       title: interface Factor
@@ -236,7 +236,7 @@ reference:
               type: string
               description: (authentication_factor.sms_phone_number)
   php:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: AuthenticationFactor
       id: authentication_factor
       title: WorkOS\Resource\AuthenticationFactor
@@ -280,7 +280,7 @@ reference:
               type: string
               description: (authentication_factor.sms_phone_number)
   java:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: Factor
       id: authentication_factor
       title: class Factor
@@ -327,7 +327,7 @@ reference:
               type: String
               description: (authentication_factor.sms_phone_number)
   go:
-    - url: /reference/mfa/authentication-factor
+    - url: /reference/mfa/factor
       key: Factor
       id: authentication_factor
       title: mfa.Factor
@@ -366,11 +366,10 @@ reference:
             - key: phone_number
               type: string
               description: (authentication_factor.sms_phone_number)
-originalPath: >-
-  .tmp-workos-clone/packages/docs/content/reference/mfa/authentication-factor.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/mfa/factor/index.mdx
 ---
 
-## Authentication Factor
+# Authentication Factor
 
 An object representing an Authentication Factor.
 

package/.docs/organized/docs/reference/organization/create.mdx

@@ -150,10 +150,6 @@ reference:
             - key: state
               type: '"pending" | "verified"'
               description: (domain_data.state)
-        - key: idempotency_key
-          optional: true
-          type: str
-          description: (idempotency_key)
       returns:
         - (Organization)
   php:
@@ -196,7 +192,6 @@ reference:
                 - key: State
                   type: OrganizationDomainDataState
                   description: (domain_data.state)
-        - (idempotencyKey)
         - (cancellationToken)
       returns:
         - key: Task<Organization>
@@ -208,7 +203,7 @@ originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/cre
 
 Creates a new organization in the current environment.
 
-You can include one or more domains to associate with the organization, but you should [verify the ownership](/user-management/domain-verification) of every domain before setting its state to `verified`.
+You can include one or more domains to associate with the organization, but you should [verify the ownership](/authkit/domain-verification) of every domain before setting its state to `verified`.
 
 <CodeBlock referenceId="create_organization">
   <CodeBlockTab title="Request" file="create-organization-request" />

package/.docs/organized/docs/reference/organization/get-by-external-id.mdx

@@ -29,7 +29,7 @@ originalPath: >-
 
 ## Get an Organization by External ID
 
-Get the details of an existing organization by an [external identifier](/user-management/metadata/external-identifiers).
+Get the details of an existing organization by an [external identifier](/authkit/metadata/external-identifiers).
 
 <CodeBlock referenceId="get_organization_by_external_id">
   <CodeBlockTab

package/.docs/organized/docs/reference/organization/index.mdx

@@ -7,13 +7,13 @@ descriptions:
     name: >-
       A descriptive name for the Organization. This field does not need to be
       unique.
-    domains: 'List of [Organization Domains](/reference/organization-domain).'
+    domains: 'List of [Organization Domains](/reference/domain-verification).'
     stripe_customer_id: |
       The Stripe customer ID associated with this organization.
     external_id: The external ID of the Organization.
     metadata: >-
-      Object containing [metadata](/user-management/metadata) key/value pairs
-      associated with the Organization.
+      Object containing [metadata](/authkit/metadata) key/value pairs associated
+      with the Organization.
     created_at: The timestamp when the Organization was last created.
     updated_at: The timestamp when the Organization was last updated.
   domain_data:
@@ -28,11 +28,11 @@ descriptions:
 
       to you that they own this domain. A [verified
 
-      domain](/user-management/domain-verification) may belong to multiple
+      domain](/authkit/domain-verification) may belong to multiple
 
       organizations but only a single organization can include the domain in its
 
-      [Domain Policy](/user-management/organization-policies/domain-policy),
+      [Domain Policy](/authkit/organization-policies/domain-policy),
 
       which has the potential to affect authentication policy across your
 

package/.docs/organized/docs/reference/organization/update.mdx

@@ -228,7 +228,7 @@ originalPath: .tmp-workos-clone/packages/docs/content/reference/organization/upd
 
 Updates an organization in the current environment.
 
-You can include one or more domains to associate with the organization, but you should [verify the ownership](/user-management/domain-verification) of every domain before setting its state to `verified`.
+You can include one or more domains to associate with the organization, but you should [verify the ownership](/authkit/domain-verification) of every domain before setting its state to `verified`.
 
 <CodeBlock referenceId="update_organization">
   <CodeBlockTab title="Request" file="update-organization-request" />

package/.docs/organized/docs/reference/{pagination.mdx → pagination/index.mdx}

@@ -16,7 +16,6 @@ descriptions:
     An object ID that defines your place in the list. When the ID is not
     present, you are at the end of the list.
 
-
     For example, if you make a list request and receive 100 objects, ending with
     `"obj_123"`, your subsequent call can include `before="obj_123"` to fetch a
     new batch of objects before `"obj_123"`.
@@ -24,7 +23,6 @@ descriptions:
     An object ID that defines your place in the list. When the ID is not
     present, you are at the end of the list.
 
-
     For example, if you make a list request and receive 100 objects, ending with
     `"obj_123"`, your subsequent call can include `after="obj_123"` to fetch a
     new batch of objects after `"obj_123"`.
@@ -229,7 +227,7 @@ reference:
       optional: true
       type: string
       description: (after)
-originalPath: .tmp-workos-clone/packages/docs/content/reference/pagination.mdx
+originalPath: .tmp-workos-clone/packages/docs/content/reference/pagination/index.mdx
 ---
 
 # Pagination

package/.docs/organized/docs/reference/pipes/access-token/get.mdx

@@ -0,0 +1,174 @@
+---
+descriptions:
+  pipes_access_token: The OAuth access token for the connected integration.
+  pipes_active: >-
+    Indicates whether the access token is valid and ready for use, or if
+    reauthorization is required.
+  pipes_expires_at: The ISO-8601 formatted timestamp indicating when the access token expires.
+  pipes_scopes: The scopes granted to the access token.
+  pipes_missing_scopes: >-
+    If the integration has requested scopes that aren't present on the access
+    token, they're listed here.
+  pipes_get_token:
+    slug: The identifier of the integration.
+    user_id: >-
+      A [User](/reference/authkit/user) identifier. The user must have an active
+      connection to the specified integration.
+    organization_id: >-
+      An [Organization](/reference/organization) identifier. Optional parameter
+      to scope the integration lookup to a specific organization.
+    access_token: >-
+      The [access token](/reference/pipes/access-token) object, present when
+      `active` is `true`.
+    error: >
+      - `"not_installed"`: The user does not have the integration installed.
+
+      - `"needs_reauthorization"`: The user needs to reauthorize the
+      integration.
+reference:
+  curl:
+    - key: pipes_get_token
+      id: pipes_get_token
+      url: /reference/pipes/access-token/get
+      title: '/data-integrations/:slug/token'
+      type: POST
+      parameters:
+        - key: slug
+          type: string
+          description: (pipes_get_token.slug)
+        - key: user_id
+          type: string
+          description: (pipes_get_token.user_id)
+        - key: organization_id
+          type: string
+          description: (pipes_get_token.organization_id)
+          optional: true
+      returns:
+        - key: anonymous
+          type: object
+          unwrap: true
+          properties:
+            - key: active
+              type: boolean
+              description: (pipes_active)
+            - key: access_token
+              type: access_token
+              optional: true
+              description: (pipes_get_token.access_token)
+            - key: error
+              type: '"not_installed" | "needs_reauthorization"'
+              optional: true
+              description: (pipes_get_token.error)
+  js:
+    - key: pipesGetToken
+      id: pipes_get_token
+      url: /reference/pipes/access-token/get
+      title: pipes.getAccessToken()
+      parameters:
+        - key: options
+          type: object
+          unwrap: true
+          properties:
+            - key: provider
+              type: string
+              description: (pipes_get_token.slug)
+            - key: userId
+              type: string
+              description: (pipes_get_token.user_id)
+            - key: organizationId
+              type: string
+              optional: true
+              description: (pipes_get_token.organization_id)
+      returns:
+        - key: accessToken
+          type: object | null
+          description: >-
+            Includes the access token value itself, as well as metadata about
+            the token. It's null if the token is invalid; check the `reason`
+            property for more information.
+          properties:
+            - key: token
+              type: string
+              description: (pipes_access_token)
+            - key: expiresAt
+              type: Date | null
+              description: (pipes_expires_at)
+            - key: scopes
+              type: 'string[]'
+              description: (pipes_scopes)
+            - key: missingScopes
+              type: 'string[]'
+              description: (pipes_missing_scopes)
+        - key: error
+          type: '"not_installed" | "needs_reauthorization"'
+          optional: true
+          description: (pipes_get_token.error)
+  go:
+    - key: GetAccessToken
+      id: pipes_get_token
+      url: /reference/pipes/access-token/get
+      title: pipes.GetAccessToken()
+      parameters:
+        - key: ctx
+          type: context.Context
+          description: >-
+            The [Context](https://pkg.go.dev/context) type provides information
+            about the client making the request.
+        - key: opts
+          type: pipes.GetAccessTokenOpts
+          unwrap: true
+          properties:
+            - key: Provider
+              type: string
+              description: (pipes_get_token.slug)
+            - key: UserID
+              type: string
+              description: (pipes_get_token.user_id)
+            - key: OrganizationID
+              type: string
+              optional: true
+              description: (pipes_get_token.organization_id)
+      returns:
+        - key: accessToken
+          type: pipes.AccessToken
+          description: >-
+            Includes the access token value itself, as well as metadata about
+            the token. It's null if the token is invalid; check the `reason`
+            property for more information.
+          properties:
+            - key: AccessToken
+              type: string
+              description: (pipes_access_token)
+            - key: ExpiresAt
+              type: time.Time | null
+              description: (pipes_expires_at)
+            - key: Scopes
+              type: '[]string'
+              description: (pipes_scopes)
+            - key: MissingScopes
+              type: '[]string'
+              description: (pipes_missing_scopes)
+        - key: err
+          type: pipes.NotInstalled | pipes.NeedsReauthorization | error
+          description: >
+            Includes Pipes-specific errors:
+
+            - `pipes.NotInstalled`: The user does not have the integration
+            installed.
+
+            - `pipes.NeedsReauthorization`: The user needs to reauthorize the
+            integration.
+
+
+            Network and other transient errors may also be returned.
+originalPath: .tmp-workos-clone/packages/docs/content/reference/pipes/access-token/get.mdx
+---
+
+## Get an access token for a connected account
+
+Fetches a valid OAuth access token for a user's connected account. WorkOS automatically handles token refresh, ensuring you always receive a valid, non-expired token.
+
+<CodeBlock referenceId="pipes_get_token">
+  <CodeBlockTab title="Request" file="get-token-request" />
+  <CodeBlockTab title="Response" file="get-token-response" />
+</CodeBlock>

package/.docs/organized/docs/reference/pipes/access-token/index.mdx

@@ -0,0 +1,44 @@
+---
+descriptions:
+  pipes_access_token_object:
+    object: Distinguishes the access token object.
+    access_token: The OAuth access token for the connected integration.
+    expires_at: The ISO-8601 formatted timestamp indicating when the access token expires.
+    scopes: The scopes granted to the access token.
+    missing_scopes: >-
+      If the integration has requested scopes that aren't present on the access
+      token, they're listed here.
+reference:
+  curl:
+    - url: /reference/pipes/access-token
+      key: pipes_access_token_object
+      id: pipes_access_token_object
+      title: access_token
+      properties:
+        - key: object
+          type: '"access_token"'
+          description: (pipes_access_token_object.object)
+        - key: access_token
+          type: string
+          description: (pipes_access_token_object.access_token)
+        - key: expires_at
+          type: string | null
+          description: (pipes_access_token_object.expires_at)
+        - key: scopes
+          type: 'string[]'
+          description: (pipes_access_token_object.scopes)
+        - key: missing_scopes
+          type: 'string[]'
+          description: (pipes_access_token_object.missing_scopes)
+originalPath: .tmp-workos-clone/packages/docs/content/reference/pipes/access-token/index.mdx
+---
+
+# Access Token
+
+An access token allows you to make API calls to a connected third-party service on behalf of a user. WorkOS handles token refresh automatically, so you always receive a valid, non-expired token.
+
+<CodeBlock
+  title="Access Token"
+  referenceId="pipes_access_token_object"
+  file="access-token"
+/>