Minerva

Returns every integration connection for the authenticated organization and its pending setup queue. An integration connection is one authorized external provider account. A source role brings data into Minerva. A destination role lets Minerva deliver or activate data through an external channel. Use this tool for campaign planning, channel selection, audience data, activation, measurement, and launch readiness. Prefer usable connections. A setup-queue item is a request that is not usable yet; suggest completing it when relevant. Supported destination connections include destination, destinationConfig, and audienceRequirements. Explain audienceRequirements.notice before activation; uploaded records are not matched users and a completed upload does not mean the audience is targetable. builtInDestinations lists options such as CSV that work without an account. Use destination with create_activation and supply destination_config according to its field definitions, including every required field. When a useful integration is neither connected nor queued, you may suggest adding it, but do not claim that it is connected, usable, or supported without confirmation. Use each connection's roles; do not infer roles from provider capabilities.

get_organization_integrations

Retrieves selected person-page fields for up to ten people in parallel. Use this tool after the user asks to view more details for specific people from get_person_search_preview. Pass the selected people's minerva_pid values together and choose the exact return_fields relevant to the user's request, or omit return_fields to retrieve every available person-page field. Selecting address, phone, email, employment, or education history returns the complete records in that category. Each result corresponds to the person in the same position. The person must previously have appeared in an organization preview or prior record export. This in-platform lookup does not use record capacity and is subject to anti-abuse rate limits.

get_person_details

Reads the current status and statistics for up to ten existing person searches in parallel. Pass all segment IDs awaiting status together in one call. For created, initiated, parsing_search, building_query, or querying, wait roughly 10 seconds and call this tool again with the same active segment IDs. For completed or previewed, present only the essential result: match count; applied criteria in one short line; unsupported or dropped criteria in one short line when present; email, phone, and address coverage in one line. When visual output is available, include a compact visualization of these statistics. Offer [View full insights](https://app.minerva.io/search/{segment_id}/insights) for the dashboard's distributions and full criteria. After presenting the essential result, offer three next steps: retrieve the preview of up to 25 people, export or deliver the full segment through create_activation using an available built-in or connected destination, or revise the audience criteria and run another search. When get_organization_context returned audienceScoringAvailable=true, also offer to calculate propensity scores for the audience. For failed or cancelled, present job.error, follow its retry guidance, and offer to revise the audience. Status retrieval adds no billable usage.

get_person_search_status

Retrieves compact, normalized sections from the frontend persona experience. Call list_personas first, present the available sections, and ask which sections the user wants or whether they want all. Set return_fields to those sections; omitting it returns all sections. Visualize suitable distributions and trends when visualization is available. Organization cards provide exact organization comparisons where available, while list_personas provides peer-persona context.

get_persona

Returns the organization's saved product categories, descriptions, ranks, and average order value estimates. These are saved business context, not current transaction analytics.

get_organization_product_categories

Lists the signed-in user's organization memberships and identifies the current session organization. Use this when asked which organizations the user belongs to. Status is membership state, not a guarantee of product access. This tool does not switch organizations or authorize cross-organization operations. Follow switchOrganizationInstructions; never pass another membership's organization ID to tools scoped to the current session. Unavailable while impersonating.

list_memberships

Returns accepted and historical Minerva users for the authenticated organization. isEnabled is Minerva access state, not invitation state. Users with only pending or revoked invitations are excluded.

list_organization_users

Lists personas discovered from the current session organization's connected first-party people and order data, in frontend display order. Choose the exact return_fields relevant to the request, or omit return_fields to return every available summary field. Present each persona as a linked title using `[{title}](/personas/{persona_id})` when Markdown is available. Use the persona ID internally when calling get_persona. Present the available persona sections as short choices. Tell the user that you can fetch one or more listed personas and limit each result to the specific sections they care about, or fetch every section. End with a short question asking which personas and sections they want to explore.

list_personas

Use when the user wants to find, compare, inspect, or choose segments. Search using the provided criteria. When results are broad or intent is unclear, ask one focused question and suggest relevant filters. Ask before relaxing constraints. When filtering by creator, call list_organization_users first and pass its userId as filters.created_by_user_id. Never guess or derive a creator user ID.

list_segments

Answers up to eight independent natural-language questions against the authenticated organization's governed analytics data. Results preserve input order. Keep successful results, clarify needs_input items, and retry only failures marked retryable. This tool does not accept SQL or an organization ID.

query_organization_data

Reads the organization's saved Competitors feed, newest first: news about tracked competitors, the market, and new entrants. Returns what changed, why it matters, importance, tags, and sources. Cite the sources. Filter by competitor name from get_organization_competitors, kind, importance, or tag. Insights marked not relevant are excluded. This tool does not perform new research; an empty result means nothing matched in that window. has_more means the limit truncated the feed.

get_market_insights

Retrieves every available person in a completed search's bounded overview preview, up to 25 people. This in-platform preview does not use record capacity and is subject to anti-abuse rate limits. State the total number available. Choose the exact return_fields needed to present the preview, or omit return_fields to retrieve every frontend overview field. result_rank and minerva_pid are always returned. By default, display the first 10 people in result_rank order and offer the remaining people. Display the requested count when the user specifies one. Include full_name and linkedin_url when presenting linked names. Render each name as a LinkedIn link when Markdown is supported and both fields are present, using the exact URL. Render remaining names as plain text. Describe the returned person objects as frontend overview records. After presenting the preview, offer to export or deliver the full segment through create_activation using an available built-in or connected destination.

get_person_search_preview

Creates up to five free audience searches in parallel. Turn each audience the user explicitly requests into one concise description that preserves their intended criteria. Set search_target to third_party for Minerva's US person data or first_party for the organization's connected data. Default to third_party. Ask which data source to use only when firstPartySearchAvailable=true and the source is unclear from context. Use first_party only when get_organization_context returns firstPartySearchAvailable=true. When the user requests one audience, send exactly one item. Before creating a search, compare the requested criteria with [Person Search filters](https://docs.minerva.io/api-reference/person-search-filters.md). When a criterion falls outside the supported filters, briefly identify it, explain that it is unlikely to affect the results, and offer to submit the original audience description anyway or continue with the supported criteria. Wait for the user's choice before invoking this tool. Each query contains searchable words or numbers. Poll get_person_search_status with all returned segment IDs roughly every 10 seconds until terminal. Search creation adds no billable usage. Each successful query creates a persistent segment. Search rate limits apply to each query.

person_search

Send a concise product issue or feature request to Minerva support. Requires explicit user consent (user_confirmed=true). Exclude secrets, customer records, and full conversations. Never retry automatically or claim delivery without a submitted receipt.