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.
- Site
- duckduckgo.com
- Functions
- 21
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/duckduckgoOne MCP server for DuckDuckGo and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
chatWithDuckAiSend a message to Duck.ai, DuckDuckGo's free private AI chat, with a chosen model, and return the model's reply.Arguments
Name Type Required messagestringThe message to send.Yes modelstringA model id from listDuckAiModels where entityHasAccess is true, e.g. "claude-haiku-5-5".No Returns
DuckAiReplyinterface 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/chatWithDuckAiCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.chatWithDuckAi({ message: "Reply with exactly the word: pineapple" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.chatWithDuckAi({"message": "Reply with exactly the word: pineapple"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/chatWithDuckAi \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"message":"Reply with exactly the word: pineapple"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required amountnumberYes fromstring3-letter currency code, e.g. "USD".Yes tostring3-letter currency code, e.g. "EUR".Yes Returns
DuckDuckGoCurrencyConversioninterface 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/convertCurrencyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.convertCurrency({ amount: 1, from: "USD", to: "EUR" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.convertCurrency({"amount": 1, "from": "USD", "to": "EUR"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/convertCurrency \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"amount":1,"from":"USD","to":"EUR"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.convertCurrency({ amount: 1, from: "USD", to: "EUR" });defineWordLook a word up the way DuckDuckGo's dictionary answer does.Arguments
Name Type Required 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/defineWordCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.defineWord({ word: "test" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.defineWord({"word": "test"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/defineWord \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"word":"test"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.defineWord({ word: "test" });getEmailProtectionAccountReads the signed-in caller's DuckDuckGo Email Protection account.Arguments
None.
Returns
DuckDuckGoEmailProtectionAccountinterface 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/getEmailProtectionAccountCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.getEmailProtectionAccount();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.getEmailProtectionAccount())curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/getEmailProtectionAccount \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.getEmailProtectionAccount();getInstantAnswerGet DuckDuckGo's Instant Answer for a topic.Arguments
Name Type Required querystringWhat you would type into the search box.Yes Returns
DuckDuckGoInstantAnswerinterface 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/getInstantAnswerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.getInstantAnswer({ query: "openai" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.getInstantAnswer({"query": "openai"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/getInstantAnswer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"openai"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringA place name, e.g. "New York, NY" or "Tokyo, Japan".Yes Returns
DuckDuckGoLocalTimeinterface 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/getLocalTimeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.getLocalTime({ place: "Tokyo, Japan" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.getLocalTime({"place": "Tokyo, Japan"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/getLocalTime \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"Tokyo, Japan"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required placestringA place name, e.g. "New York, NY" or "Paris, France".Yes Returns
DuckDuckGoWeatherinterface 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/getWeatherCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.getWeather({ place: "New York, NY" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.getWeather({"place": "New York, NY"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/getWeather \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"place":"New York, NY"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required filterstringMatched case-insensitively against the bang's trigger, site name, category and subcategory.No limitnumberDefault 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/listBangsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.listBangs({ filter: "wikipedia" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.listBangs({"filter": "wikipedia"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/listBangs \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"filter":"wikipedia"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listDuckAiModelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.listDuckAiModels();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.listDuckAiModels())curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/listDuckAiModels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listRegionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.listRegions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.listRegions())curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/listRegions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.listRegions();resolveBangTurn a !bang query ("!w duck", "!a usb-c cable") into the destination URL DuckDuckGo would redirect to.Arguments
Name Type Required querystringA bang query, trigger either leading ("!w duck") or trailing ("duck !w").Yes Returns
DuckDuckGoBangResolutioninterface 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/resolveBangCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.resolveBang({ query: "!w duck" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.resolveBang({"query": "!w duck"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/resolveBang \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"!w duck"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes cursorstringThe next value a previous call returned, to fetch the following page.No Returns
SearchImagesResultinterface 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/searchImagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.searchImages({ query: "cat" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.searchImages({"query": "cat"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/searchImages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"cat"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.searchNews({ query: "climate change" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.searchNews({"query": "climate change"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/searchNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"climate change"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.searchNews({ query: "climate change" });searchPlacesFind places on DuckDuckGo Maps by what and where ("coffee in Seattle").Arguments
Name Type Required querystringWhat you would type into a maps search box.Yes nearstringA place name to search around, e.g. "Manhattan, New York".No cursorstringThe next value a previous call returned, to fetch the following page.No Returns
SearchPlacesResultinterface 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/searchPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.searchPlaces({ query: "coffee near me" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.searchPlaces({"query": "coffee near me"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/searchPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"coffee near me"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes cursorstringThe next value a previous call returned, to fetch the following page.No Returns
SearchVideosResultinterface 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/searchVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.searchVideos({ query: "python tutorial" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.searchVideos({"query": "python tutorial"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/searchVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"python tutorial"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringWhat you would type into duckduckgo.com's search box.Yes regionstringDuckDuckGo 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 cursorstringThe next value a previous call returned, to fetch the following page.No Returns
DuckDuckGoSearchWebResultinterface 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/searchWebCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.searchWeb({ query: "rust programming language" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.searchWeb({"query": "rust programming language"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/searchWeb \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"rust programming language"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.searchWeb({ query: "rust programming language" });suggestQueriesReturn DuckDuckGo's search-box autocomplete suggestions for a partial query.Arguments
Name Type Required querystringThe partial query to complete, e.g. "open".Yes Returns
string[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/duckduckgo/suggestQueriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.suggestQueries({ query: "open" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.suggestQueries({"query": "open"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/suggestQueries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"open"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required textstringYes tostringA language name DuckDuckGo's own translate trigger recognizes, e.g. "french".Yes Returns
DuckDuckGoTranslationinterface 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/translateTextCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.translateText({ text: "hello", to: "french" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.translateText({"text": "hello", "to": "french"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/translateText \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"text":"hello","to":"french"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.translateText({ text: "hello", to: "french" });
changeForwardingAddressChange the inbox the signed-in caller's @duck.com addresses forward to.Arguments
Name Type Required newEmailstringThe new inbox DuckDuckGo should forward @duck.com mail to.Yes otpstringOmit to START the change (sends a confirmation email).No hashstringThe hash the start call returned.No Returns
DuckDuckGoForwardingChangeResultinterface 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/changeForwardingAddressCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.changeForwardingAddress({ newEmail: "<newEmail>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.changeForwardingAddress({"newEmail": "<newEmail>"}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/changeForwardingAddress \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"newEmail":"<newEmail>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
DuckDuckGoCreatedPrivateAddressinterface DuckDuckGoCreatedPrivateAddress { address: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/duckduckgo/createPrivateDuckAddressCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.createPrivateDuckAddress();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.createPrivateDuckAddress())curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/createPrivateDuckAddress \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required linkstringThe deactivate/reactivate link at the foot of a mail DuckDuckGo forwarded.No addressstringThe private address, "abc123" or "abc123@duck.com".No addressTokenstringThe link's address_token query value.No activebooleanFalse stops forwarding, true resumes it.No Returns
DuckDuckGoPrivateAddressStateinterface DuckDuckGoPrivateAddressState { address: string; active: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/duckduckgo/setPrivateDuckAddressActiveCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.duckduckgo.setPrivateDuckAddressActive({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.duckduckgo.setPrivateDuckAddressActive({}))curl -X POST https://api.bowmark.ai/v1/sites/duckduckgo/setPrivateDuckAddressActive \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.duckduckgo.setPrivateDuckAddressActive({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/duckduckgo/<function> - OpenAPI
/v1/sites/duckduckgo/openapi.json