MolTrust

MolTrust Auth API

The Auth API from MolTrust — 5 operation(s) for auth.

Documentation GitHub OpenAPI

Business capability

Developer Identity & Credential Management BC-4270.40

Operations 5

POST /auth/moltbook Auth With Moltbook #

GET /auth/github Github Auth Start #

GET /auth/github/callback Github Auth Callback #

POST /auth/signup Signup For Api Key #

POST /auth/signup-did Signup By Signature #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/moltrust-ch:moltrust-ch-auth-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: MolTrust Auth API
  version: '2.5'
tags:
- name: Auth
paths:
  /auth/moltbook:
    post:
      summary: Auth With Moltbook
      operationId: auth_with_moltbook_auth_moltbook_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MoltbookAuthRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Auth
  /auth/github:
    get:
      summary: Github Auth Start
      description: Redirect to GitHub OAuth
      operationId: github_auth_start_auth_github_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Auth
  /auth/github/callback:
    get:
      summary: Github Auth Callback
      operationId: github_auth_callback_auth_github_callback_get
      parameters:
      - name: code
        in: query
        required: true
        schema:
          type: string
          maxLength: 128
          title: Code
      - name: state
        in: query
        required: false
        schema:
          type: string
          maxLength: 64
          default: ''
          title: State
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Auth
  /auth/signup:
    post:
      summary: Signup For Api Key
      operationId: signup_for_api_key_auth_signup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Auth
  /auth/signup-did:
    post:
      summary: Signup By Signature
      description: 'Mint an API key by proving key possession instead of owning a mailbox.


        An agent that registered through /identity/register-pop already holds an

        Ed25519 key the server knows. Requiring an email on top of that asks for a

        human and a mailbox to stand behind something that is not about either —

        and every mailbox-shaped identity is one more thing to Sybil.


        Same challenge, same proof-of-work, same signature check as keyless

        registration. The key is bound to the DID that owns the public key, so it

        cannot be minted for an agent the caller does not control.'
      operationId: signup_by_signature_auth_signup_did_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DidSignupRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Auth
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    DidSignupRequest:
      properties:
        public_key:
          type: string
          maxLength: 128
          title: Public Key
        challenge:
          type: string
          maxLength: 256
          title: Challenge
        signature:
          type: string
          maxLength: 256
          title: Signature
        pow_nonce:
          type: string
          maxLength: 64
          title: Pow Nonce
      type: object
      required:
      - public_key
      - challenge
      - signature
      - pow_nonce
      title: DidSignupRequest
    SignupRequest:
      properties:
        email:
          type: string
          maxLength: 256
          title: Email
      type: object
      required:
      - email
      title: SignupRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MoltbookAuthRequest:
      properties:
        token:
          type: string
          maxLength: 512
          minLength: 10
          title: Token
      type: object
      required:
      - token
      title: MoltbookAuthRequest