Scribd MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Scribd: 21 typed functions through one MCP server. No Scribd API key needed.

Functions
21
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Scribd

An MCP server for Scribd alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/scribd
Every site

One MCP server for Scribd and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 13
  • askDocumentAsks Scribd's AI assistant a question about one document and returns its answer, as the signed-in caller.

    Arguments

    NameTypeRequired
    documentstring | numberYes
    questionstringYes

    Returns ScribdAnswer

    interface ScribdAnswer {
      id: number;
      question: string;
      answer: string | null;
      sources: unknown[];
      suggestions: string[];
      chatGuid: string | null;
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/askDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.askDocument("705834178", "What is this document about?");
  • downloadDocumentDownloads a document's file (PDF, DOCX, TXT … as its formats list offers) for the signed-in caller, returning the file as base64.

    Arguments

    NameTypeRequired
    documentstring | numberYes
    formatstringNo

    Returns ScribdDownload

    interface ScribdDownload {
      id: number;
      format: string;
      fileName: string | null;
      contentType: string | null;
      size: number;
      base64: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/downloadDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.downloadDocument("705834178");
  • getDocumentReads one document's metadata.

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdDocument

    interface ScribdDocument {
      id: number;
      title: string;
      url: string;
      type: string;
      description?: string;
      summary?: string;
      uploader?: { name: string; url?: string };
      pageCount?: number;
      pageDimensions?: { width: number; height: number };
      wordCount?: number;
      views?: string;
      rating: { upvoteCount: number; downvoteCount: number; ratingCount: number; averageRating?: number };
      formats: Array<{ extension: string; filesize?: string }>;
      isDownloadable: boolean;
      isViewRestricted: boolean;
      isPrivate: boolean;
      copyright?: string;
      categories: string[];
      keyphrases: Array<{ keyphrase: string; definition: string; pageNum?: number }>;
      questions: Array<{ question: string; answer: string }>;
      imageUrl?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getDocument("705834178");
  • getDocumentTextReads the full extracted text of a public document, page by page where the site marks pages.

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdDocumentText

    interface ScribdDocumentText {
      id: number;
      title?: string;
      text: string;
      paragraphCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getDocumentText

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getDocumentText("705834178");
  • getEmbedCodeReturns Scribd's documented, keyless oEmbed for a public document.

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdEmbedCode

    interface ScribdEmbedCode {
      html: string;
      title: string;
      authorName?: string;
      authorUrl?: string;
      thumbnailUrl?: string;
      thumbnailWidth?: number;
      thumbnailHeight?: number;
      aspectRatio?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getEmbedCode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getEmbedCode("705834178");
  • getListReads a public Scribd list (a curated collection of documents) from a scribd.com/lists/<id>/<slug> url or the numeric id: the list's name…

    Arguments

    NameTypeRequired
    liststring | numberYes

    Returns ScribdList

    interface ScribdList {
      id: number;
      name: string;
      description?: string;
      isPrivate: boolean;
      url: string;
      author?: { name: string; url?: string };
      documents: Array<{
        id: number;
        title: string;
        url: string;
        author?: { name: string; url?: string };
        description?: string;
        pageCount?: number;
        imageUrl?: string;
        type: string;
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getList("21567494");
  • getRelatedDocumentsLists the documents Scribd recommends alongside one document ("more like this" and related lists).

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdRelatedDocument[]

    interface ScribdRelatedDocument {
      id: number;
      title: string;
      url: string;
      author?: { name: string; url?: string };
      description?: string;
      pageCount?: number;
      views?: string;
      rating: { upCount: number; count: number };
      imageUrl?: string;
      type: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getRelatedDocuments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getRelatedDocuments("705834178");
  • getTrendingDocumentsLists the documents trending on Scribd right now, overall or in one category, plus the site's editorial lists ("Business Templates" …).

    Arguments

    NameTypeRequired
    categorystringNo

    Returns ScribdTrendingModule[]

    interface ScribdTrendingDocument {
      id: number;
      title: string;
      url: string;
      author?: { name: string; url?: string };
      pageCount?: number;
      views?: string;
      upvoteCount: number;
      downvoteCount: number;
      imageUrl?: string;
      type: string;
    }
    
    interface ScribdTrendingModule {
      title: string;
      category?: string;
      url?: string;
      documents: ScribdTrendingDocument[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getTrendingDocuments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getTrendingDocuments();
  • getUserProfileReads a Scribd uploader's public profile.

    Arguments

    NameTypeRequired
    userstring | numberYes

    Returns ScribdUserProfile

    interface ScribdUserProfile {
      id: number;
      name: string;
      url: string;
      avatarUrl?: string;
      modules: Array<{
        title: string;
        type: string;
        url?: string;
        documents: Array<{
          id: number;
          title: string;
          url: string;
          description?: string;
          views?: string;
          upvoteCount: number;
          downvoteCount: number;
          language?: string;
          imageUrl?: string;
          type: string;
        }>;
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/getUserProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.getUserProfile("387748862");
  • listCategoriesLists Scribd's document categories (Art, Business, Career & Growth, Finance & Money Management, Law, Science & Mathematics, Teaching Methods &…

    Arguments

    None.

    Returns ScribdCategory[]

    interface ScribdCategory {
      name: string;
      slug: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.listCategories();
  • listMyListsLists the signed-in caller's own lists (collections), with each list's id, name, privacy and document count.

    Arguments

    None.

    Returns ScribdMyList[]

    interface ScribdMyList {
      id: number | string | null;
      name: string | null;
      url: string | null;
      privacy: string | null;
      documentCount: number | null;
      raw: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/listMyLists

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.listMyLists();
  • listSavedDocumentsLists the documents in the signed-in caller's library.

    Arguments

    None.

    Returns ScribdSavedDocuments

    interface ScribdList {
      id: number;
      name: string;
      description?: string;
      isPrivate: boolean;
      url: string;
      author?: { name: string; url?: string };
      documents: Array<{
        id: number;
        title: string;
        url: string;
        author?: { name: string; url?: string };
        description?: string;
        pageCount?: number;
        imageUrl?: string;
        type: string;
      }>;
    }
    
    interface ScribdSavedDocuments {
      documents: ScribdList["documents"];
      savedIds: number[];
      finishedIds: number[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/listSavedDocuments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.listSavedDocuments();
  • searchDocumentsSearches Scribd's user-uploaded documents by free text ("python tutorial", "lease agreement template") and returns up to 40 a page: id, title, url…

    Arguments

    NameTypeRequired
    querystringYes
    pagenumberNo

    Returns ScribdSearchResult[]

    interface ScribdSearchResult {
      id: number;
      title: string;
      url: string;
      author: { name: string; url?: string };
      description?: string;
      pageCount?: number;
      views?: string;
      upvoteCount: number;
      downvoteCount: number;
      imageUrl?: string;
      type: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/searchDocuments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.searchDocuments("python");
Act 8
  • addDocumentToListAdds a document to one of the signed-in caller's lists.

    Arguments

    NameTypeRequired
    liststring | numberYes
    documentstring | numberYes

    Returns ScribdListWriteResult

    interface ScribdListWriteResult {
      listId: string;
      documentId: number;
      added: boolean;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/addDocumentToList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.addDocumentToList("<list>", "<document>");
  • createListCreates a new list (collection) on the signed-in caller's account, private unless asked public, optionally starting it with one document.

    Arguments

    NameTypeRequired
    namestringYes
    options{ privacy?: 'private' | 'public'; document?: string | number }No

    Returns ScribdCreatedList

    interface ScribdCreatedList {
      id: number | string | null;
      name: string;
      privacy: "private" | "public";
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/createList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.createList("<name>");
  • deleteDocumentDeletes one of the signed-in caller's own uploaded documents.

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdDeleteResult

    interface ScribdDeleteResult {
      id: number;
      deleted: true;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/deleteDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.deleteDocument("<document>");
  • markDocumentFinishedMarks a document in the signed-in caller's library as finished reading, or back to saved.

    Arguments

    NameTypeRequired
    documentstring | numberYes
    finishedbooleanNo

    Returns ScribdFinishResult

    interface ScribdFinishResult {
      id: number;
      finished: boolean;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/markDocumentFinished

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.markDocumentFinished("<document>");
  • rateDocumentRates a document helpful or not helpful (Scribd's thumbs up / thumbs down) as the signed-in caller, or clears the rating.

    Arguments

    NameTypeRequired
    documentstring | numberYes
    rating'up' | 'down' | 'clear'Yes

    Returns ScribdRatingResult

    interface ScribdRatingResult {
      id: number;
      rating: "up" | "down" | "clear";
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/rateDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.rateDocument("<document>", "up");
  • removeDocumentFromListRemoves a document from one of the signed-in caller's lists.

    Arguments

    NameTypeRequired
    liststring | numberYes
    documentstring | numberYes

    Returns ScribdListWriteResult

    interface ScribdListWriteResult {
      listId: string;
      documentId: number;
      added: boolean;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/removeDocumentFromList

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.removeDocumentFromList("<list>", "<document>");
  • saveDocumentSaves a document to the signed-in caller's library (the bookmark icon on every document).

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdSaveResult

    interface ScribdSaveResult {
      id: number;
      saved: boolean;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/saveDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.saveDocument("<document>");
  • unsaveDocumentRemoves a document from the signed-in caller's saved library.

    Arguments

    NameTypeRequired
    documentstring | numberYes

    Returns ScribdSaveResult

    interface ScribdSaveResult {
      id: number;
      saved: boolean;
      response?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/scribd/unsaveDocument

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.scribd.unsaveDocument("<document>");

Use it from code