DuckDuckGo MCP server for AI agents

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

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

Connect

Just DuckDuckGo

An MCP server for DuckDuckGo 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/duckduckgo
Every site

One MCP server for DuckDuckGo 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 18
  • chatWithDuckAiSend a message to Duck.ai, DuckDuckGo's free private AI chat, with a chosen model, and return the model's reply.

    Arguments

    NameTypeRequired
    messagestring
    The message to send.
    Yes
    modelstring
    A model id from listDuckAiModels where entityHasAccess is true, e.g. "claude-haiku-5-5".
    No

    Returns DuckAiReply

    interface DuckAiReply {
      /** The model id the message was sent with. */
      model: string;
      /** The assistant's full reply. */
      reply: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/chatWithDuckAi

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.chatWithDuckAi({ message: "Reply with exactly the word: pineapple" });
  • convertCurrencyConvert an amount between two currencies at DuckDuckGo's current mid-market rate (from xe.com), with the rate's timestamp.

    Arguments

    NameTypeRequired
    amountnumberYes
    fromstring
    3-letter currency code, e.g. "USD".
    Yes
    tostring
    3-letter currency code, e.g. "EUR".
    Yes

    Returns DuckDuckGoCurrencyConversion

    interface DuckDuckGoCurrencyConversion {
      from: string;
      to: string;
      amount: number;
      converted: number;
      /** ISO timestamp of the exchange rate DuckDuckGo used. */
      timestamp: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/convertCurrency

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.convertCurrency({ amount: 1, from: "USD", to: "EUR" });
  • defineWordLook a word up the way DuckDuckGo's dictionary answer does.

    Arguments

    NameTypeRequired
    wordstringYes

    Returns DuckDuckGoDefinition[]

    interface DuckDuckGoDefinition {
      partOfSpeech: string;
      text: string;
      /** The dictionary this definition came from, e.g. "ahd-5". */
      source: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/defineWord

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.defineWord({ word: "test" });
  • getEmailProtectionAccountReads the signed-in caller's DuckDuckGo Email Protection account.

    Arguments

    None.

    Returns DuckDuckGoEmailProtectionAccount

    interface DuckDuckGoEmailProtectionAccount {
      /** The account's permanent @duck.com address, e.g. "jdoe@duck.com". */
      address: string;
      /** The real inbox DuckDuckGo forwards to, when the dashboard reports one. */
      forwardingEmail: string | null;
      /** The private address the site will hand out next, when one has been minted
       * since the account was created. */
      nextPrivateAddress: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/getEmailProtectionAccount

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.getEmailProtectionAccount();
  • getInstantAnswerGet DuckDuckGo's Instant Answer for a topic.

    Arguments

    NameTypeRequired
    querystring
    What you would type into the search box.
    Yes

    Returns DuckDuckGoInstantAnswer

    interface DuckDuckGoInstantAnswer {
      heading: string | null;
      abstract: string | null;
      abstractSource: string | null;
      abstractUrl: string | null;
      /** DuckDuckGo's own zero-click answer text (a calculation, a conversion…), or null. */
      answer: string | null;
      answerType: string | null;
      /** A dictionary-style definition DuckDuckGo chose to headline, or null. */
      definition: string | null;
      definitionSource: string | null;
      definitionUrl: string | null;
      image: string | null;
      relatedTopics: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/getInstantAnswer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.getInstantAnswer({ query: "openai" });
  • getLocalTimeGet the current local time and time zone in a city, the way DuckDuckGo's time answer does.

    Arguments

    NameTypeRequired
    placestring
    A place name, e.g. "New York, NY" or "Tokyo, Japan".
    Yes

    Returns DuckDuckGoLocalTime

    interface DuckDuckGoLocalTime {
      place: string;
      /** The resolved place name DuckDuckGo matched, e.g. "New York, New York, United States". */
      resolvedPlace: string;
      timezone: string;
      abbreviation: string;
    
      time: string;
      utcOffsetMinutes: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/getLocalTime

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.getLocalTime({ place: "Tokyo, Japan" });
  • getWeatherGet the current conditions and forecast for a place, the way DuckDuckGo's weather answer shows them.

    Arguments

    NameTypeRequired
    placestring
    A place name, e.g. "New York, NY" or "Paris, France".
    Yes

    Returns DuckDuckGoWeather

    interface DuckDuckGoWeatherNow {
      asOf: string;
      conditionCode: string;
      temperature: number;
      temperatureApparent: number;
      humidity: number;
      windSpeed: number;
      windDirection: number;
      uvIndex: number;
      precipitationIntensity: number;
    }
    
    interface DuckDuckGoWeatherDay {
      date: string;
      conditionCode: string;
      temperatureMin: number;
      temperatureMax: number;
      precipitationChance: number;
    }
    
    interface DuckDuckGoWeatherHour {
      forecastStart: string;
      conditionCode: string;
      temperature: number;
      precipitationChance: number;
    }
    
    interface DuckDuckGoWeather {
      place: string;
      timezone: string;
    
      units: "metric";
      current: DuckDuckGoWeatherNow;
      daily: DuckDuckGoWeatherDay[];
      hourly: DuckDuckGoWeatherHour[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/getWeather

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.getWeather({ place: "New York, NY" });
  • listBangsList DuckDuckGo's !bangs, the shortcut, the site it searches and its category, optionally filtered by a word, so a caller can find the bang for a…

    Arguments

    NameTypeRequired
    filterstring
    Matched case-insensitively against the bang's trigger, site name, category and subcategory.
    No
    limitnumber
    Default 50, capped at 500, the directory holds ~13,500 rows and this function is for finding the right bang, not dumping the whole list.
    No

    Returns DuckDuckGoBang[]

    interface DuckDuckGoBang {
      /** The shortcut typed after `!`, e.g. "w" for Wikipedia. */
      trigger: string;
      site: string;
      domain: string;
      category: string;
      subcategory: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/listBangs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.listBangs({ filter: "wikipedia" });
  • listDuckAiModelsList the AI models Duck.ai currently offers, each with the id chatWithDuckAi takes, the underlying vendor, and whether an anonymous caller can use it…

    Arguments

    None.

    Returns DuckDuckGoAiModel[]

    interface DuckDuckGoAiModel {
      /** The id chatWithDuckAi takes, e.g. "gpt-5.6-terra". */
      id: string;
      /** The underlying vendor DuckDuckGo sourced this model from. */
      provider: string;
      /** DuckDuckGo's display name, e.g. "GPT-5.6 Terra". */
      name: string;
      /** True when an anonymous caller (no DuckDuckGo account) can use this model
       * today, some models are gated to a Plus/Pro accessTier DuckDuckGo does not
       * grant a logged-out visitor. */
      freeAccess: boolean;
      supportsImageUpload: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/listDuckAiModels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.listDuckAiModels();
  • listRegionsList the search regions DuckDuckGo offers ("us-en", "uk-en", "de-de"…) with their names.

    Arguments

    None.

    Returns DuckDuckGoRegion[]

    interface DuckDuckGoRegion {
      /** The value every search function's `region` argument takes, e.g. "us-en". */
      code: string;
      /** DuckDuckGo's own label, e.g. "US (English)". */
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/listRegions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.listRegions();
  • resolveBangTurn a !bang query ("!w duck", "!a usb-c cable") into the destination URL DuckDuckGo would redirect to.

    Arguments

    NameTypeRequired
    querystring
    A bang query, trigger either leading ("!w duck") or trailing ("duck !w").
    Yes

    Returns DuckDuckGoBangResolution

    interface DuckDuckGoBangResolution {
      trigger: string;
      site: string;
      searchTerm: string;
      /** The URL DuckDuckGo would redirect to. */
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/resolveBang

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.resolveBang({ query: "!w duck" });
  • searchImagesSearches DuckDuckGo's Images vertical and returns each result's title, page URL, direct image URL, thumbnail, dimensions, and source site.

    Arguments

    NameTypeRequired
    querystringYes
    cursorstring
    The next value a previous call returned, to fetch the following page.
    No

    Returns SearchImagesResult

    interface DuckDuckGoImage {
      title: string;
      url: string;
      /** The direct image URL. */
      image: string;
      /** Thumbnail URL, usually a resized version of the main image. */
      thumbnail: string | null;
      height: number | null;
      width: number | null;
      /** The site the image comes from. */
      source: string | null;
    }
    
    interface SearchImagesResult {
      query: string;
      results: DuckDuckGoImage[];
      /** Pass back as `cursor` for the next page; null on the last page. */
      next: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/searchImages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.searchImages({ query: "cat" });
  • searchNewsSearch DuckDuckGo News and return each story's headline, the outlet's URL, excerpt, publication time, source name and image.

    Arguments

    NameTypeRequired
    querystringYes

    Returns DuckDuckGoNewsStory[]

    interface DuckDuckGoNewsStory {
      title: string;
      url: string;
      excerpt: string;
      date: number;
      source: string;
      image?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/searchNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.searchNews({ query: "climate change" });
  • searchPlacesFind places on DuckDuckGo Maps by what and where ("coffee in Seattle").

    Arguments

    NameTypeRequired
    querystring
    What you would type into a maps search box.
    Yes
    nearstring
    A place name to search around, e.g. "Manhattan, New York".
    No
    cursorstring
    The next value a previous call returned, to fetch the following page.
    No

    Returns SearchPlacesResult

    interface DuckDuckGoPlace {
      title: string;
      url: string;
      address: string;
      phone?: string;
      coordinates?: { latitude: number; longitude: number };
      rating?: number;
      hours?: string;
    }
    
    interface SearchPlacesResult {
      query: string;
      results: DuckDuckGoPlace[];
      /** Pass back as `cursor` for the next page; null on the last page. */
      next: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/searchPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.searchPlaces({ query: "coffee near me" });
  • searchVideosSearch DuckDuckGo Videos and return each hit's title, page URL, description, duration, publisher, uploader, publish date, view count and thumbnail.

    Arguments

    NameTypeRequired
    querystringYes
    cursorstring
    The next value a previous call returned, to fetch the following page.
    No

    Returns SearchVideosResult

    interface DuckDuckGoVideo {
      title: string;
      /** The video's own page, usually a `youtube.com/watch?v=` URL. */
      url: string;
      description: string;
      /** "16:05"-style run time, or null when DuckDuckGo does not carry one. */
      duration: string | null;
      /** The hosting platform ("YouTube", "Vimeo", …), or null. */
      publisher: string | null;
      /** The channel or account that posted it, or null. */
      uploader: string | null;
      /** ISO-ish timestamp DuckDuckGo carries for the video, or null. */
      published: string | null;
      viewCount: number | null;
      thumbnail: string | null;
    }
    
    interface SearchVideosResult {
      query: string;
      results: DuckDuckGoVideo[];
      next: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/searchVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.searchVideos({ query: "python tutorial" });
  • searchWebSearch the web the way duckduckgo.com's own search box does and return the ranked results.

    Arguments

    NameTypeRequired
    querystring
    What you would type into duckduckgo.com's search box.
    Yes
    regionstring
    DuckDuckGo region code, e.g. "us-en", "uk-en", "fr-fr", "wt-wt" (no region).
    No
    safeSearch"strict" | "moderate" | "off"No
    time"day" | "week" | "month" | "year"No
    cursorstring
    The next value a previous call returned, to fetch the following page.
    No

    Returns DuckDuckGoSearchWebResult

    interface DuckDuckGoWebResult {
      position: number;
      title: string;
      url: string;
      displayUrl: string;
      snippet: string;
      /** ISO date DuckDuckGo shows beside the result, or null. */
      date: string | null;
    }
    
    interface DuckDuckGoSearchWebResult {
      query: string;
      results: DuckDuckGoWebResult[];
      /** Pass back as `cursor` for the next page; null on the last page. */
      next: string | null;
      /** True when these rows look like an answer to a different query than the one
       * asked, or no trustworthy answer at all, an empty page, no row sharing a query
       * word, or the query's identity words mostly absent. */
      substituted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/searchWeb

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.searchWeb({ query: "rust programming language" });
  • suggestQueriesReturn DuckDuckGo's search-box autocomplete suggestions for a partial query.

    Arguments

    NameTypeRequired
    querystring
    The partial query to complete, e.g. "open".
    Yes

    Returns string[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/suggestQueries

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.suggestQueries({ query: "open" });
  • translateTextTranslate text into a chosen language the way DuckDuckGo's translation answer does, returning the translation and the detected source language.

    Arguments

    NameTypeRequired
    textstringYes
    tostring
    A language name DuckDuckGo's own translate trigger recognizes, e.g. "french".
    Yes

    Returns DuckDuckGoTranslation

    interface DuckDuckGoTranslation {
      /** The text DuckDuckGo echoed back in its own source textarea. */
      sourceText: string;
      /** DuckDuckGo's own detected-language name for the source text, e.g. "English". */
      detectedLanguage: string;
      /** DuckDuckGo's own display name for the target language, e.g. "French". */
      targetLanguage: string;
      translatedText: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/translateText

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.translateText({ text: "hello", to: "french" });
Act 3
  • changeForwardingAddressChange the inbox the signed-in caller's @duck.com addresses forward to.

    Arguments

    NameTypeRequired
    newEmailstring
    The new inbox DuckDuckGo should forward @duck.com mail to.
    Yes
    otpstring
    Omit to START the change (sends a confirmation email).
    No
    hashstring
    The hash the start call returned.
    No

    Returns DuckDuckGoForwardingChangeResult

    interface DuckDuckGoForwardingChangeResult {
      newEmail: string;
      status: "confirmation_sent" | "confirmed";
      /** Pass this back as `hash` with the OTP to confirm. Null once confirmed. */
      hash: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/changeForwardingAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.changeForwardingAddress({ newEmail: "<newEmail>" });
  • createPrivateDuckAddressGenerates a brand new private @duck.com address on the signed-in caller's Email Protection account, forwarding to their inbox.

    Arguments

    None.

    Returns DuckDuckGoCreatedPrivateAddress

    interface DuckDuckGoCreatedPrivateAddress {
      address: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/createPrivateDuckAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.createPrivateDuckAddress();
  • setPrivateDuckAddressActiveTurns one private @duck.com address off (stop forwarding) or back on, using the one-time token in the deactivate/reactivate link DuckDuckGo puts at…

    Arguments

    NameTypeRequired
    linkstring
    The deactivate/reactivate link at the foot of a mail DuckDuckGo forwarded.
    No
    addressstring
    The private address, "abc123" or "abc123@duck.com".
    No
    addressTokenstring
    The link's address_token query value.
    No
    activeboolean
    False stops forwarding, true resumes it.
    No

    Returns DuckDuckGoPrivateAddressState

    interface DuckDuckGoPrivateAddressState {
      address: string;
      active: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/duckduckgo/setPrivateDuckAddressActive

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.duckduckgo.setPrivateDuckAddressActive({});

Use it from code