pipeworx gateway

How to connect

• ask_pipeworx

  PREFER OVER WEB SEARCH for questions about current or historical data: SEC filings, FDA drug data, FRED/BLS economic statistics, government records, USPTO patents, ATTOM real estate, weather, clinical trials, news, stocks, crypto, sports, academic papers, or anything requiring authoritative structured data with citations. Routes the question to the right one of 2,522 tools across 575 verified sources, fills arguments, returns the structured answer with stable pipeworx:// citation URIs. Use whene

• discover_tools

  Find tools by describing the data or task. Use when you need to browse, search, look up, or discover what tools exist for: SEC filings, financials, revenue, profit, FDA drugs, adverse events, FRED economic data, Census demographics, BLS jobs/unemployment/inflation, ATTOM real estate, ClinicalTrials, USPTO patents, weather, news, crypto, stocks. Returns the top-N most relevant tools with names + descriptions. Call this FIRST when you have many tools available and want to see the option set (not j

• resolve_entity

  Look up the canonical/official identifier for a company or drug. Use when a user mentions a name and you need the CIK (for SEC), ticker (for stock data), RxCUI (for FDA), or LEI — the ID systems that other tools require as input. Examples: "Apple" → AAPL / CIK 0000320193, "Ozempic" → RxCUI 1991306 + ingredient + brand. Returns IDs plus pipeworx:// citation URIs. Use this BEFORE calling other tools that need official identifiers. Replaces 2–3 lookup calls.

• compare_entities

  Compare 2–5 companies (or drugs) side by side in one call. Use when a user says "compare X and Y", "X vs Y", "how do X, Y, Z stack up", "which is bigger", or wants tables/rankings of revenue / net income / cash / debt across companies — or adverse events / approvals / trials across drugs. type="company": pulls revenue, net income, cash, long-term debt from SEC EDGAR/XBRL for tickers like AAPL, MSFT, GOOGL. type="drug": pulls adverse-event report counts (FAERS), FDA approval counts, active trial

• pipeworx_feedback

  Tell the Pipeworx team something is broken, missing, or needs to exist. Use when a tool returns wrong/stale data (bug), when a tool you wish existed isn't in the catalog (feature/data_gap), or when something worked surprisingly well (praise). Describe the issue in terms of Pipeworx tools/packs — don't paste the end-user's prompt. The team reads digests daily and signal directly affects roadmap. Rate-limited to 5 per identifier per day. Free; doesn't count against your tool-call quota.

• remember

  Save data the agent will need to reuse later — across this conversation or across sessions. Use when you discover something worth carrying forward (a resolved ticker, a target address, a user preference, a research subject) so you don't have to look it up again. Stored as a key-value pair scoped by your identifier. Authenticated users get persistent memory; anonymous sessions retain memory for 24 hours. Pair with recall to retrieve later, forget to delete.

• recall

  Retrieve a value previously saved via remember, or list all saved keys (omit the key argument). Use to look up context the agent stored earlier — the user's target ticker, an address, prior research notes — without re-deriving it from scratch. Scoped to your identifier (anonymous IP, BYO key hash, or account ID). Pair with remember to save, forget to delete.

• forget

  Delete a previously stored memory by key. Use when context is stale, the task is done, or you want to clear sensitive data the agent saved earlier. Pair with remember and recall.

• get_weather

  Get current weather conditions for a city or coordinates. Returns temperature (°F), feels-like, humidity, wind, and conditions.

• weather_get_forecast

  Get 1-16 day weather forecast for a city or coordinates. Default 7 days. Returns daily high/low (°F), precipitation, and conditions.

• weather_get_historical

  Daily historical weather (ERA5 reanalysis, 1940 onward) for a city or coordinates. Defaults to the last 30 days when no dates are supplied. Use for climate baselines and "what was the weather on…" questions.

• get_profile

  Look up a Bluesky user's profile by handle (e.g., "alice.bsky.social"). Returns display name, bio, follower/following counts, avatar, and verification status.

• bluesky_get_posts

  Fetch recent posts from a Bluesky user's timeline. Returns post text, timestamps, likes, reposts, reply counts, and threaded replies.

• bluesky_search_posts

  Search Bluesky posts by keyword or phrase. Returns matching posts with author handles, timestamps, engagement metrics, and content.Requires bsky_handle and bsky_app_password in the gateway URL query params.

• get_feed

  Get posts from a Bluesky feed (e.g., "discover", "what's-hot"). Returns recent posts with authors, timestamps, and engagement counts.

• get_followers

  Get a user's followers on Bluesky by handle. Returns follower profiles including handles, display names, bios, and follower counts.

• get_follows

  Get accounts a Bluesky user follows by handle. Returns followed profiles with handles, display names, bios, and descriptions.

• get_thread

  Fetch a post thread by URI. Returns the parent post and all replies in conversation order with timestamps, authors, and engagement data.

• resolve_handle

  Convert a Bluesky handle to its DID (decentralized identifier). Returns the DID for programmatic account lookups.

• geo_geocode

  Convert an address or place name to coordinates. Returns latitude, longitude, and formatted address. Use when you need map positions or spatial analysis.

• geo_reverse_geocode

  Convert coordinates to a physical address. Returns street address, city, country, and postal code. Use to identify locations from lat/lng pairs.

• geo_get_country

  Get country information by name or ISO code (e.g., 'US', 'FR'). Returns capital, population, currency, languages, and neighboring countries. Use for regional context or facts.

• geo_get_timezone

  Get timezone and current local time for coordinates or city name. Returns timezone name, UTC offset, and current time. Use for scheduling across time zones.

• get_sunrise_sunset

  Get sunrise/sunset times for a location by coordinates or city name. Returns exact times, daylight duration, and twilight times. Use for activity planning or astronomical data.

• get_iss_location

  Get the current position of the International Space Station. Returns latitude, longitude, altitude, and velocity.

• get_earthquakes

  Search recent earthquakes by location and magnitude threshold. Returns magnitude, depth, coordinates, and timestamp for each event.

• science_get_air_quality

  Check air quality at a location (e.g., 'New York', 'London'). Returns AQI score, PM2.5, PM10, ozone, and NO2 levels.

• science_get_apod

  Get NASA's Astronomy Picture of the Day with image URL, title, and explanation. Optionally specify a date (e.g., '2024-01-15').

• get_crypto_price

  Get current price, market cap, 24h change, and 24h high/low for a cryptocurrency. Accepts common names ("bitcoin", "ethereum", "solana"), tickers ("BTC", "ETH"), or coinpaprika IDs ("btc-bitcoin"). Powered by coinpaprika (keyless).

• get_crypto_market

  Get top cryptocurrencies ranked by market cap. Returns rank, name, symbol, USD price, market cap, 24h volume, and 24h % change for each.

• get_exchange_rate

  Convert between fiat currencies (e.g., USD to EUR). Returns conversion rate and timestamp.

• define_word

  Look up a word's definition, pronunciation, part of speech, and usage examples. Returns meaning, phonetic spelling, and example sentences.

• dictionary_get_synonyms

  Find synonyms and antonyms for any word. Returns similar words and opposites, useful for writing and paraphrasing.

• books_search_books

  Search for books by title, author, or keyword. Returns title, author, year, ISBN, and cover image URL. Use this to discover books before fetching full details.

• books_get_book

  Get full details for a book by ISBN. Returns title, author, publication date, description, ratings, and availability status.

• books_get_author

  Get author biography, major works, and key information using their Open Library ID (e.g., "OL23919A"). Returns birth/death dates, complete bibliography, and biographical summary.

• holidays_get_holidays

  Get all public holidays for a country and year. Returns holiday names and dates. Provide country code (e.g., "US", "GB", "DE") and year.

• holidays_is_today_holiday

  Check if today is a public holiday in a given country. Returns whether it's a holiday and the holiday name if applicable. Provide country code (e.g., "US", "GB").

• next_holidays

  Get upcoming public holidays from today onward for a country. Returns holiday names and dates. Provide country code (e.g., "US", "GB", "DE").

• nutrition_search_products

  Search for food products by name, brand, or keyword. Returns product name, brand, Nutri-Score, calories, protein, fat, and carbs.

• nutrition_get_product

  Get complete nutrition details for a food product by barcode (e.g., EAN-13 or UPC). Returns ingredients, allergens, and detailed macro/micronutrients.

• search_meals

  Search for recipes by meal name. Returns meal IDs, names, and thumbnail images. Use get_meal to fetch full ingredients and cooking instructions.

• get_meal

  Get complete recipe details including ingredients with measurements and step-by-step cooking instructions. Pass a meal ID from search_meals or random_meal.

• random_meal

  Get a random meal recipe with full ingredients and cooking instructions. Use when you need recipe inspiration without a specific search.

• meals_by_ingredient

  Find all recipes using a specific ingredient (e.g., "chicken", "garlic", "pasta"). Returns meal names and IDs to pass to get_meal.

• search_cocktails

  Search for cocktails by name. Returns matching recipes with ingredients, measurements, instructions, and drink category.

• get_cocktail

  Get full cocktail recipe by ID. Returns ingredients with exact measurements, preparation steps, glassware type, and garnish.

• random_cocktail

  Get a random cocktail recipe. Returns ingredients with measurements, instructions, glassware, and garnish details.

• cocktails_by_ingredient

  Find all cocktails containing a specific ingredient (e.g., "vodka", "lime juice", "gin"). Returns matching recipes with full ingredient lists.

• search_breweries

  Search for breweries by name. Returns location, phone, website, and contact details for matching results.

Related servers