Search / direct.vote/vote-direct
vote.direct
R0· no sign-inRun a real election or board vote: price it, check state HOA rules, draft the ballot and voter list.
v1.2.0 · active · website · descriptor JSON · versions
Search / direct.vote/vote-direct
R0· no sign-inRun a real election or board vote: price it, check state HOA rules, draft the ballot and voter list.
v1.2.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"vote-direct": {
"type": "http",
"url": "https://vote.direct/api/mcp",
"headers": {
"Authorization": "Bearer ${VOTE_DIRECT_TOKEN}"
}
}
}
}claude mcp add --transport http vote-direct https://vote.direct/api/mcp --header "Authorization: Bearer ${VOTE_DIRECT_TOKEN}"[mcp_servers.vote-direct]
url = "https://vote.direct/api/mcp"
bearer_token_env_var = "VOTE_DIRECT_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"vote-direct": {
"type": "remote",
"url": "https://vote.direct/api/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:VOTE_DIRECT_TOKEN}"
}
}
}
}{
"mcpServers": {
"vote-direct": {
"type": "http",
"url": "https://vote.direct/api/mcp",
"headers": {
"Authorization": "Bearer ${VOTE_DIRECT_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=vote-direct&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vdm90ZS5kaXJlY3QvYXBpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1ZPVEVfRElSRUNUX1RPS0VOfSJ9fQ%3D%3D"
}{
"servers": {
"vote-direct": {
"type": "http",
"url": "https://vote.direct/api/mcp",
"headers": {
"Authorization": "Bearer ${VOTE_DIRECT_TOKEN}"
}
}
}
}{
"mcpServers": {
"vote-direct": {
"httpUrl": "https://vote.direct/api/mcp",
"headers": {
"Authorization": "Bearer ${VOTE_DIRECT_TOKEN}"
}
}
}
}extensions:
"vote-direct":
enabled: true
name: "vote-direct"
type: streamable_http
uri: "https://vote.direct/api/mcp"
headers:
"Authorization": "Bearer ${VOTE_DIRECT_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${VOTE_DIRECT_TOKEN}. The registry never accepts secret values.
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations18 of 18 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 8,842 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes28 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageupdate_election_draftchangedinput schemacreate_election_draftchangedinput schemastart_election_draftchangedinput schemacreate_checkout_linkaddedA secure Stripe payment page for a DRAFT election's fee, for the person you act for to pay by card. It creates the page and charges nothing: hand the person the link. The page asks for exactly the price get_election_price reports. Publishing follows the payment either way: the election's page, where Stripe returns them, publishes it once the payment lands, and publish_election with after_payment: true publishes it from here or answers already_published. Refused when nothing is owed (free, already paid, or covered by a plan) and when the prepaid balance covers the fee, because publishing then takes it without a card.
publish_electionchangeddescription, input schemaPublish a DRAFT election in the connected account, running every check the publish button runs (ballot, schedule, voter list, state law, price) and charging the price from the account's prepaid balance or plan. Free elections (up to 25 voters) publish at no cost. If the balance does not cover it, nothing is charged and the person pays by card at the finish link instead. Publishing does NOT send invitations: the organizer sends them from the election page. Confirm with the person before calling this; it can spend their money.
Publish a DRAFT election in the connected account, running every check the publish button runs (ballot, schedule, voter list, state law, price) and charging the price from the account's prepaid balance or plan. Free elections (up to 25 voters) publish at no cost. If the balance does not cover it, nothing is charged and the person pays by card, at the finish link or on a payment page from create_checkout_link. Publishing follows a card payment either way: the page the person returns to from Stripe publishes once the payment lands, or call this with after_payment: true, which waits for the payment and publishes without a second charge, never drawing on the balance as well. An election that is already published and paid for answers status already_published with its links, not a refusal. Once published it emails voters their ballots when it can send as the organizer; through an assistant connection it usually cannot, so the result says whether ballots were emailed and, if not, links the election page where the organizer sends them. Confirm with the person before calling this; it can spend their money.
remove_votersaddedTake voters off a DRAFT election in the connected account, by email address or by unit. A voter goes when their email is named, or when every unit they hold is named, so nobody loses a unit by accident; the contact book is not touched. Returns how many were taken off and how many of those named are not on the list, never the rows, and the updated price.
add_voterschangeddescriptionAdd eligible voters (email, optional name and unit) to a DRAFT election in the connected account. Idempotent: people already on the list are skipped. Returns how many were added and the updated price. For a published election, voters are added by the organizer on the election page, because a larger list can change the price.
Add eligible voters (email, optional name and unit) to a DRAFT election in the connected account, through the import the voter list page uses. Idempotent: people already on the list are skipped, a voter listed twice is added once, and rows that cannot be added are named by row number. Returns counts, never the rows, and the updated price. For a published election, voters are added by the organizer on the election page, because a larger list can change the price.
update_election_draftaddedChange a DRAFT election in the connected account: title, description, organization name, schedule and time zone, secret ballot, results visibility, quorum, and the ballot (add, remove or change questions, or replace them all). While nobody has paid for it, its state, community type, vote type and verification can change too. Fields mean what they mean in create_election_draft. Changes go through the election editor, so anything the election page would refuse is refused with its reason and nothing is half-changed where that can be checked first. Returns one plain sentence per change, written from the saved election, and what still blocks publishing. A published election is changed by the organizer on its page.
create_election_draftchangeddescriptionCreate a DRAFT election in the connected account: the ballot, schedule, verification, secrecy, results visibility, optional quorum and state-law checks, and optionally the voter list (emails). A draft charges nothing and contacts nobody. Returns the draft's id, what still blocks publishing, the exact price, and the finish link where the person reviews, pays if needed, and publishes. Ask the person for anything you do not know (closing date and time zone, seats, candidates) rather than guessing: this is a binding vote.
Create a DRAFT election in the connected account: the ballot, schedule, verification, secrecy, results visibility, optional quorum and state-law checks, and optionally the voter list (emails). A draft charges nothing and contacts nobody. Returns the draft's id, the draft as saved, what still blocks publishing, the exact price, and the finish link where the person reviews, pays if needed, and publishes. Create it once and change it with update_election_draft: an account can create 10 elections an hour. Ask the person for anything you do not know (closing date and time zone, seats, candidates) rather than guessing: this is a binding vote.
get_election_priceaddedThe price of one election in the connected account as it stands, from the same function the payment page and the publish step charge: its voter count, the tier, what the total is made of (government ID, texts for a small roster), and who pays it now (free, plan, prepaid balance, or card). Ask again after the voter list changes. Changes nothing.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-97% +updated-20d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://vote.direct/api/mcp streamable-http | none | yes | 97% | 422 ms | 2025-06-18 | 2026-10-20 |
add_voters | Add eligible voters (email, optional name and unit) to a DRAFT election in the connected account, through the import the voter list page uses. Idempotent: people already on the list are skipped, a voter listed twice is added once, and rows that cannot be added are named by row number. Returns counts, never the rows, and the updated price. For a published election, voters are added by the organizer on the election page, because a larger list can change the price. |
compare_platformsread-only | Honest head-to-head between vote.direct and a named competitor (including the cases where the competitor is the better choice), with published prices checked on the competitor’s own pages, a vendor disclosure, and the price-beat offer where the competitor is a paid election platform. Without a competitor, returns which-platform-for-which-need guidance. |
create_checkout_link | A secure Stripe payment page for a DRAFT election's fee, for the person you act for to pay by card. It creates the page and charges nothing: hand the person the link. The page asks for exactly the price get_election_price reports. Publishing follows the payment either way: the election's page, where Stripe returns them, publishes it once the payment lands, and publish_election with after_payment: true publishes it from here or answers already_published. Refused when nothing is owed (free, already paid, or covered by a plan) and when the prepaid balance covers the fee, because publishing then takes it without a card. |
create_election_draft | Create a DRAFT election in the connected account: the ballot, schedule, verification, secrecy, results visibility, optional quorum and state-law checks, and optionally the voter list (emails). A draft charges nothing and contacts nobody. Returns the draft's id, the draft as saved, what still blocks publishing, the exact price, and the finish link where the person reviews, pays if needed, and publishes. Create it once and change it with update_election_draft: an account can create 10 elections an hour. Ask the person for anything you do not know (closing date and time zone, seats, candidates) rather than guessing: this is a binding vote. |
create_survey | Create a free, anonymous survey in the connected account and publish it (or save it as a draft with publish: false). Surveys are for feedback, not binding votes: anyone with the link can answer and respondents are not verified. For anything binding (a board election, a bylaw amendment, an assessment) use create_election_draft. Question types: single (pick one), multiple (checkboxes), yes_no, rating (1-5 by default; settings {scale: "nps"} makes a 0-10 Net Promoter Score), ranking, open_text. Returns the share link. |
get_electionread-only | One election or survey in the connected account, as it is saved now: the schedule in its time zone, every question with its type, seats and options (in the words create_election_draft takes), the settings, the voter list as counts, ballots cast, turnout and quorum, and links. For a DRAFT election it also reports what still blocks publishing, what is worth checking, the exact price the publish step would charge, and who pays it (free, plan, prepaid balance, or card at the finish link). Per-question results are on the election page link; this tool reports counts only, never a voter's name, email or phone number. |
get_election_priceread-only | The price of one election in the connected account as it stands, from the same function the payment page and the publish step charge: its voter count, the tier, what the total is made of (government ID, texts for a small roster), and who pays it now (free, plan, prepaid balance, or card). Ask again after the voter list changes. Changes nothing. |
get_election_readinessread-only | Whether a DRAFT election in the connected account can publish now: the checks the publish button runs (schedule, ballot, voter list, state rules, size), each blocker in the words publish would refuse with, warnings a board should hear (voting closes inside the state's notice period, no quorum on an HOA or condo, voters the emailed ballot cannot reach), the exact price and who pays it. Fixing one blocker can show the next, so ask again after each fix. Changes nothing. |
get_governance_center_overviewread-only | governance.center, the second product from this team: the Board Office for a volunteer-run HOA, condo, nonprofit board, club or congregation. Returns the annual price for a given community size from the same constants Stripe bills, what every band includes, what is priced per use, what the product deliberately does not do, and the support line. Annual price first; the monthly figure is only an explainer. |
get_platform_overviewread-only | Factual overview of vote.direct: free tier and pricing model, verification ladder, ballot-secrecy modes, the dispute-evidence pack (audit trail, results certificate, receipts), voting channels, question types, the full feature list with the no-tier-lock rule, who owns and runs the company, the founder's direct line, and where to read more. |
get_price_quoteread-only | Exact, current vote.direct pricing for an election: flat rate by voter count (email verification included, SMS on paid elections), optional government-ID and mailed-letter add-ons, promotional pricing status, whether a subscription would beat paying per election, and the price-beat offer (vote.direct beats a lower quote from another provider for the same self-serve online election). Same constants the product bills against. |
get_review_recordread-only | The complete third-party review record for vote.direct: every published Capterra and Trustpilot review quoted verbatim with links, including the honest caveats (small record, TrustScore explanation, which reviewers had actually run an election, and anything a reviewer received from us). |
get_state_hoa_rulesread-only | Stored HOA/condo voting-rule summary for any US state: whether electronic voting is expressly allowed, key statutes with citations, quorum, notice and proxy rules, and whether vote.direct may serve as inspector of elections there. Summaries support review; they are not legal advice. |
list_electionsread-only | Elections and surveys in the connected vote.direct account, newest first: id, slug, title, kind (election or survey), status (draft, scheduled, live, closed), schedule, voters and ballots cast, and the links to hand the person. |
publish_electiondestructive | Publish a DRAFT election in the connected account, running every check the publish button runs (ballot, schedule, voter list, state law, price) and charging the price from the account's prepaid balance or plan. Free elections (up to 25 voters) publish at no cost. If the balance does not cover it, nothing is charged and the person pays by card, at the finish link or on a payment page from create_checkout_link. Publishing follows a card payment either way: the page the person returns to from Stripe publishes once the payment lands, or call this with after_payment: true, which waits for the payment and publishes without a second charge, never drawing on the balance as well. An election that is already published and paid for answers status already_published with its links, not a refusal. Once published it emails voters their ballots when it can send as the organizer; through an assistant connection it usually cannot, so the result says whether ballots were emailed and, if not, links the election page where the organizer sends them. Confirm with the person before calling this; it can spend their money. |
remove_votersdestructive | Take voters off a DRAFT election in the connected account, by email address or by unit. A voter goes when their email is named, or when every unit they hold is named, so nobody loses a unit by accident; the contact book is not touched. Returns how many were taken off and how many of those named are not on the list, never the rows, and the updated price. |
start_election_draft | Build a complete election (ballot, schedule, verification, voter emails) for a person who does not have a vote.direct account yet, and get the link where they claim it: they open it, create an account with their email, and the election appears in their dashboard ready to review and publish. Nothing is charged and no voter is contacted until they do. The link expires in 48 hours. For a person who has an account, or will sign in, create_election_draft works in their account directly. |
update_election_draft | Change a DRAFT election in the connected account: title, description, organization name, schedule and time zone, secret ballot, results visibility, quorum, and the ballot (add, remove or change questions, or replace them all). While nobody has paid for it, its state, community type, vote type and verification can change too. Fields mean what they mean in create_election_draft. Changes go through the election editor, so anything the election page would refuse is refused with its reason and nothing is half-changed where that can be checked first. Returns one plain sentence per change, written from the saved election, and what still blocks publishing. A published election is changed by the organizer on its page. |
Schemas: list_tools.
{
"name": "direct.vote/vote-direct",
"title": "vote.direct",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://vote.direct/api/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Optional. Clients that support MCP OAuth sign the person in automatically on the first account tool call. Clients that cannot sign in send a Bearer vd_agent_... key from https://vote.direct/settings/agents instead."
}
]
}
],
"version": "1.2.0",
"websiteUrl": "https://vote.direct/agents",
"description": "Run a real election or board vote: price it, check state HOA rules, draft the ballot and voter list."
}