InnoVint MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.7.4Updated Nov 7, 2026

Review winery lots, vessels, analyses and work history; record analyses and add vendors.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted InnoVint connector that lets an assistant review winery lots, vessels, lab analyses and cellar work history, and record analyses or add vendors.

What you can do
  • List and inspect wineries, lots, lot composition, components and per-lot costs
  • List vessels and what each held at a past date-time
  • Read lab and in-house analyses, additives and analysis types
  • Browse work history: additions, transfers, adjustments, fruit receiving and analysis actions
  • List vineyards, blocks, growers, grower receipts, vendors and bonds
  • Record analysis results on a lot or vessel, and create a vendor
When to use it
Useful when a winery already runs InnoVint and wants to ask questions in plain language about lot status, aging, pH and SO2 results, additions, racking or vintage intake, or to log analysis results without opening the app.
Requirements
Remote MCP endpoint added by URL only; sign-in is OAuth with InnoVint credentials, so no API key or Authorization header goes in the client config. A personal access token is created in InnoVint under Developer, and each hosted connection is limited to one verified winery, identified by its Winery ID. Usage is metered per winery.
Before you install
Two tools write to InnoVint records: recording analysis actions and creating vendors. The server asks for confirmation first, but wrong values become part of the winery's compliance records. Usage is billed per winery: free tier is 50 calls a month, Pro is $9/month or $90/year with a 10,000-call fair-use limit, and upgrade tools return Stripe payment links. Cancelling gives no refund for the current period.

Installation

In SourceWeft

  1. Open InnoVint MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Finnovint/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "innovint-by-usefulapi": {
      "type": "http",
      "url": "https://innovint.usefulapi.io/mcp"
    }
  }
}

README

InnoVint MCP by usefulapi

Hosted at https://innovint.usefulapi.io/mcp.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://innovint.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http innovint https://innovint.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "innovint": {      "url": "https://innovint.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your InnoVint credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/innovint/

Create a personal access token in InnoVint under Developer → Personal Access Tokens. Each hosted connection is limited to one verified winery, with usage and billing per winery. Enter its Winery ID, or leave that field blank only when the token accesses exactly one winery.

Tools

ToolTypeWhat it does
innovint_list_wineriesreadList wineries
innovint_get_wineryreadGet winery
innovint_list_lotsreadList lots
innovint_get_lotreadGet lot
innovint_get_lot_compositionreadGet lot composition
innovint_get_lot_components_summaryreadGet lot components summary
innovint_list_lot_analysesreadList lot analyses
innovint_list_lot_additivesreadList lot additives
innovint_list_lot_costsreadList lot costs
innovint_list_vesselsreadList vessels
innovint_list_vessels_at_point_in_timereadList vessels at a point in time
innovint_list_actionsreadList actions (work history)
innovint_list_analysis_actionsreadList analysis actions
innovint_list_addition_actionsreadList addition actions
innovint_list_transfer_actionsreadList transfer actions
innovint_list_adjustment_actionsreadList adjustment actions
innovint_list_receive_fruit_actionsreadList fruit receiving actions
innovint_list_analysis_typesreadList analysis types
innovint_list_additivesreadList additives
innovint_list_vineyardsreadList vineyards
innovint_list_blocksreadList vineyard blocks
innovint_list_growersreadList growers
innovint_list_grower_receiptsreadList grower receipts for a vintage
innovint_list_vendorsreadList vendors
innovint_list_bondsreadList bonds
innovint_create_analysis_actionwriteRecord analysis results
innovint_create_vendorwriteCreate vendor
innovint_usage_statusmetaUsage status (free-tier meter)
innovint_request_featuremetaRequest a missing feature
innovint_upgrademetaUpgrade to Pro or Pro+
innovint_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per connected winery)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with innovint_upgrade (it returns a Stripe Checkout link). Cancel any time with innovint_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running innovint_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/innovint/README.md at commit 4046075

Tools

27

innovint_list_wineries

List wineries

List the connected winery with id, name and the user's permissions. Hosted connections and scoped stdio return only the selected winery; unscoped stdio lists all accessible wineries. GET /api/v1/wineries or /api/v1/wineries/{wineryId}.

Parameterslimitoffset

innovint_get_winery

Get winery

One winery by id: name, internal id and the token user's permissions there. GET /api/v1/wineries/{wineryId}.

Parameterswinery_idrequired

innovint_list_lots

List lots

List the winery's lots (wine, juice, fruit or case-goods batches) with code, name, stage, color, type, tax class, volume, weight, bottles on hand and tags. Filter by search term, code, id, bond, archived state or last update. GET /api/v1/wineries/{wineryId}/lots.

Parametersqid_inlimitoffsetbond_incode_inarchivedwinery_idrequiredupdated_afterupdated_before

innovint_get_lot

Get lot

One lot by id with its stage, volume, weight, bottles on hand, tags and links to related data. GET /api/v1/wineries/{wineryId}/lots/{id}.

Parameterslot_idrequiredwinery_idrequired

innovint_get_lot_composition

Get lot composition

The lot's makeup composition (what it is made of), now or right after a given action. GET /api/v1/wineries/{wineryId}/lots/{lotId}/makeupComposition.

Parameterslot_idrequiredwinery_idrequiredafter_action

innovint_get_lot_components_summary

Get lot components summary

A summary of the lot's components. GET /api/v1/wineries/{wineryId}/lots/{lotId}/componentsSummary.

Parameterslot_idrequiredwinery_idrequired

innovint_list_lot_analyses

List lot analyses

Lab and in-house analysis results recorded on a lot (pH, TA, free SO2, Brix, VA, ...). Filter by analysis type slug, vessel or date range. GET /api/v1/wineries/{wineryId}/lots/{lotId}/analyses.

Parameterssortlimitlot_idrequiredoffsetvesselswinery_idrequiredanalysis_typerecorded_afterrecorded_beforeis_lot_composite

innovint_list_lot_additives

List lot additives

Additives that have been added to a lot. GET /api/v1/wineries/{wineryId}/lots/{lotId}/additives.

Parameterslimitlot_idrequiredoffsetwinery_idrequired

innovint_list_lot_costs

List lot costs

Cost data per lot as of a date. Filter by lot code or id. GET /api/v1/wineries/{wineryId}/lotCosts.

Parameterslimitlot_inoffsetcode_inwinery_idrequiredeffective_atmodified_after

innovint_list_vessels

List vessels

List tanks, barrels and other vessels with their codes and current contents. Filter by search term, code, id, lot or archived state. GET /api/v1/wineries/{wineryId}/vessels.

Parametersqid_inlimitlot_inoffsetcode_inarchivedwinery_idrequired

innovint_list_vessels_at_point_in_time

List vessels at a point in time

Preview (vendor contract may change): What every vessel held at a past date-time (history of cellar contents). GET /api/v1/wineries/{wineryId}/vesselsAtPointInTime.

Parametersqlimitoffsetwinery_idrequiredvessel_typeeffective_atrequired

innovint_list_actions

List actions (work history)

The winery's work history across all action types (additions, analyses, transfers, racking, blending, bottling, fruit receiving, ...), filterable by type, state, reference number and dates. Each record has the action type, effective date and the lots and vessels involved; use the typed list tools for full detail of one kind. GET /api/v1/wineries/{wineryId}/actions.

Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more

innovint_list_analysis_actions

List analysis actions

Analysis actions: the lab and in-house results entered in the winery, with the analyses (type, value, unit) and the lots and vessels they were taken on. GET /api/v1/wineries/{wineryId}/actions/analysisActions.

Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more

innovint_list_addition_actions

List addition actions

Addition actions: what additives were added to which lots and vessels, and when. GET /api/v1/wineries/{wineryId}/additionActions.

Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more

innovint_list_transfer_actions

List transfer actions

Transfer actions: racking, filtering, topping off, barrel-down and other transfers between vessels. GET /api/v1/wineries/{wineryId}/transferActions.

Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more

innovint_list_adjustment_actions

List adjustment actions

Adjustment actions: volume or weight changes, water adds and makeup changes. GET /api/v1/wineries/{wineryId}/actions/adjustmentActions.

Parametersidsortlimitstateoffsetwinery_idrequiredaction_typecreated_afterupdated_aftercreated_beforeupdated_beforeeffective_after+2 more

innovint_list_receive_fruit_actions

List fruit receiving actions

Fruit receiving actions (harvest intake) with the fruit received and the lots created. GET /api/v1/wineries/{wineryId}/actions/receiveFruitActions.

Parametersidsortlimitstateoffsetwinery_idrequiredcreated_afterupdated_aftercreated_beforeupdated_beforeeffective_aftereffective_before+1 more

innovint_list_analysis_types

List analysis types

The analysis types InnoVint knows (pH, TA, free SO2, Brix, ...), with the slug that innovint_create_analysis_action and the analysis filters need. GET /api/v1/analysisTypes.

Parametersqsluglimitoffset

innovint_list_additives

List additives

The winery's additive products and their batches. GET /api/v1/wineries/{wineryId}/additives.

Parametersqtagsid_inlimitoffsetarchivedwinery_idrequiredproduct_name_in

innovint_list_vineyards

List vineyards

The winery's vineyards (grower sources). GET /api/v1/wineries/{wineryId}/vineyards.

Parametersid_inlimitoffsetwinery_idrequired

innovint_list_blocks

List vineyard blocks

Vineyard blocks of the winery's vineyards. Filter by vineyard. GET /api/v1/wineries/{wineryId}/blocks.

Parametersid_inlimitoffsetarchivedwinery_idrequiredvineyard_in

innovint_list_growers

List growers

The growers the winery buys fruit from. GET /api/v1/wineries/{wineryId}/growers.

Parametersidlimitoffsetwinery_idrequired

innovint_list_grower_receipts

List grower receipts for a vintage

Fruit receipts from growers for one vintage (year). GET /api/v1/wineries/{wineryId}/growerReceipts/{vintage}.

Parameterslimitoffsetvintagerequiredwinery_idrequired

innovint_list_vendors

List vendors

The winery's vendors (suppliers of additives, dry goods, services). GET /api/v1/wineries/{wineryId}/vendors.

Parametersnamesortid_inlimitoffsetwinery_idrequiredname_contains

innovint_list_bonds

List bonds

The winery's bonded premises (TTB bonds), whose ids lots belong to. GET /api/v1/wineries/{wineryId}/bonds.

Parameterslimitoffsetwinery_idrequired

innovint_create_analysis_action

Record analysis results

WRITE: records analysis results (e.g. pH 3.45, free SO2 28 mg/L) as a new analysis action in the winery's InnoVint records, effective at the given time. Each result needs an analysis type slug (innovint_list_analysis_types), a value and a unit, and a lot (add a vessel for a vessel-level result; without a vessel it is a lot composite result). The new action shows up in the cellar history and feeds lot data and reports; InnoVint's API has no delete here, so only call this when the numbers are confirmed. POST /api/v1/wineries/{wineryId}/actions/analysisActions.

Parametersnoteanalysesrequiredwinery_idrequiredpanel_nameeffective_atrequired

innovint_create_vendor

Create vendor

WRITE: adds a new vendor (supplier) by name to the winery's InnoVint records. Check innovint_list_vendors first to avoid a duplicate. POST /api/v1/wineries/{wineryId}/vendors.

Parametersnamerequiredwinery_idrequired

Version history

11
  1. v1.7.4LatestNov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.2Oct 30, 2026
  11. v1.0.0Oct 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations