# Wolfram Alpha

> Query Wolfram|Alpha for math, science, units, finance and facts.

Lets an agent query the Wolfram|Alpha computational knowledge engine - math,
science, units, finance, geography, dates and general factual questions. All
actions are read-only.

## What it can do

| Method | What it does |
| --- | --- |
| `wolfram_query` | Full Results API (`/v2/query`, JSON) - structured pods with plaintext, assumptions and step-by-step solutions. |
| `wolfram_result` | Short Answers API (`/v1/result`) - one-line plain-text answer. |
| `wolfram_spoken` | Spoken Results API (`/v1/spoken`) - conversational, speech-friendly answer. |
| `wolfram_llm` | LLM API (`/api/v1/llm-api`) - LLM-friendly plain-text result with a website link. |
| `wolfram_request` | Generic passthrough to any other Wolfram endpoint (GET). |

## How to get credentials

This connector uses an **AppID** (passed as a query parameter, not a header).

1. Go to the [Wolfram|Alpha Developer Portal](https://developer.wolframalpha.com/access)
   and sign in (a free Wolfram ID works).
2. Open **My Apps** and click **Get an AppID**.
3. Give the app a name and description, then **Get AppID**.
4. Copy the AppID (looks like `XXXXXX-XXXXXXXXXX`) and paste it into FlyMyAI.

One AppID covers all endpoints. Note the free tier has a monthly query cap;
heavier use needs a paid plan.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `WOLFRAM_APP_ID` | Wolfram|Alpha Developer Portal -> My Apps -> Get an AppID |

## Troubleshooting

- **`403 Forbidden` / "Invalid appid"** - the AppID is wrong, or you are using
  it with the wrong API (each AppID works across all of them, so re-copy it).
- **`501 Not Implemented`** - Wolfram could not interpret the query or has no
  result; rephrase it or try `wolfram_query` for richer output.
- **No / empty answer** - the Short/Spoken APIs return only a one-line answer;
  use `wolfram_query` or `wolfram_llm` for full detail.
- **Monthly cap reached** - the free tier limits queries per month; upgrade the
  plan for more volume.

## Links

- [Wolfram|Alpha Developer Portal](https://developer.wolframalpha.com/access)
- [Wolfram|Alpha API documentation](https://products.wolframalpha.com/api)