fovub documentation
fovub projects the share of the vote between two people for one local nonpartisan elected seat, such as a city council, school board, college board, water board, or county seat, before either person declares. Each trustee area or district is its own seat. fovub does not compare positions, and it does not cover partisan state or national races.
Connect. fovub is an MCP server at https://fovub.com/mcp, and Claude or any other app that
supports MCP can connect to it. In Claude, add the URL as a custom connector; it needs no client ID or secret. Claude
Code signs in through a loopback address on any port. Other apps may register any https return address or their own app
scheme. Voice input often writes fovub as "for Bob", "four Bob", or "fob".
Sign in. find_seat runs without sign-in. The first call to any other tool opens fovub's sign-in page, where you sign in to fovub with Google. fovub's consent page names the app, your fovub email, and your balance, and it states that each projection takes $1 from the balance. Allow connects the app, and Cancel refuses it.
Prices. A new account starts at $0, and Palo Alto Data Group may email it a one-use demo code worth $3, enough for three projections. A projection holds $1 when it starts, spends it when the projection returns, and returns it when the projection fails. The full report on a projection costs $10 from the balance, on the projection's page at fovub.com. Credit sells in $10 packs on Stripe's payment page. Discussing a result in your app takes nothing from the balance.
Tools.
- find_seat searches fovub's seats from words such as a seat's name and place. It is free, needs no sign-in, and returns up to eight seats, each with the seat_id that start_projection takes.
- start_projection starts a $1 projection from a seat_id and two names, person_a and person_b.
- check_projection takes a run_id and waits up to 50 seconds (wait_seconds). It returns one of four states: working; waiting, with a question; done, with the shares and fovub's warning; or failed, with the reason.
- answer_question sends the answer to a projection's question from the run_id, the question's seq, and an answer, or answers for a question with several parts.
- account returns the email, the balance, the prices, and where to add credit.
- add_balance returns Stripe's payment page for a pack, where the user pays in a browser. With several packs for sale and no price_id, it lists the packs. The balance rises when Stripe confirms the payment.
Every tool except find_seat needs the fovub sign-in.
A projection, step by step.
- Find the seat with find_seat, and confirm it with the user.
- Start the projection with start_projection.
- Check it with check_projection.
- Put each question to the user exactly as fovub asks it, and send the answer with answer_question.
- Read the result, which arrives after about ten minutes.
Results. A result gives each person's share of the vote in whole percents, fovub's warning that the method is version 1.0 and its accuracy is not yet known, and the "Scored as of" date. When a count or result of the election reached the projection, the result says the projection is not blind. A finished projection names its page on fovub.com, where the full report is sold. The full report is a PDF with each candidate's standing in each topic group of campaign activities, each campaign's frame, the hours analysis, a win strategy for each candidate, the 51% line, and the sources.
Troubleshooting.
- When no seat matches, give the seat's full name and place.
- A projection started while fovub's projection server starts up fails, returns the $1, and says to try again in two minutes.
- When the balance is below the price, add credit with add_balance or at fovub.com.
- A tool that needs sign-in makes the app start fovub's sign-in.
- Seat searches without sign-in stop at 10 per IP address and 30 in all each hour, and the whole site runs at most 300 Claude calls a day.
End access or delete your data. Removing fovub from an app's connectors stops that app from calling fovub. The Delete my data button, beside Sign out on fovub.com, deletes your personal information from your account; fovub.com/privacy states what it removes and what it keeps.
Support. Write to information@paloaltodatagroup.com.
fovub, brought to you by Palo Alto Data Group. Privacy.