Civic Marketplace

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Delete supplier catalog. Requires the matching supplier dashboard write scope. Changes may be visible on the public Civic Marketplace supplier profile.

delete_supplier_catalog

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Delete supplier link. Requires the matching supplier dashboard write scope. Changes may be visible on the public Civic Marketplace supplier profile.

delete_supplier_link

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Delete supplier video. Requires the matching supplier dashboard write scope. Changes may be visible on the public Civic Marketplace supplier profile.

delete_supplier_video

Read messages in one or more Civic Marketplace inbox conversations for the authenticated agency or supplier. Provide either conversation_id for one conversation or conversation_ids for up to 5 conversations. Batch requests fetch each conversation concurrently, return separate pagination metadata for each, and support up to 25 messages per conversation. Requires inbox:read or inbox:write.

get_inbox_messages

Return the authenticated agency or supplier user's unread Civic Marketplace inbox conversation count. Requires inbox:read or inbox:write.

get_inbox_unread_count

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. View a privacy-minimized summary of the authenticated supplier profile, including public company details, services, certifications, states served, and capacity. NIGP classes are canonical zero-padded strings. Use the dedicated address, media, or reference tools only when the user explicitly requests those records. Requires supplier-profile:read or supplier-profile:write.

get_my_supplier_profile

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. View supplier dashboard analytics and profile completeness for the authenticated supplier. Requires supplier-analytics:read.

get_supplier_analytics_summary

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. Get one coop quote request sent to the authenticated supplier only. Requires supplier OAuth context and quote-requests:read or quote-requests:write.

get_supplier_coop_quote_request

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. Get one quick quote request sent to the authenticated supplier only. Requires supplier OAuth context and quote-requests:read or quote-requests:write.

get_supplier_quick_quote_request

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. Summarize quote request statuses sent to the authenticated supplier only. Includes under_review and closed. Requires supplier OAuth context and quote-requests:read or quote-requests:write.

get_supplier_quote_request_status_summary

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Get the full details for one reference owned by the authenticated supplier, including reviewer details, ratings, review text, status, and timestamps. Requires supplier-references:read or supplier-references:write.

get_supplier_reference

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Get one solicitation available to the authenticated supplier, including documents, requested items, and this supplier's questions/bid status. Requires supplier-solicitations:read.

get_supplier_solicitation

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Invite a teammate by sending an email invitation to the authenticated supplier account. Requires team:write and supplier admin access.

invite_supplier_team_member

List the authenticated agency or supplier user's Civic Marketplace inbox conversations, optionally unread only. Requires inbox:read or inbox:write. These are marketplace threads, not email messages; show the counterparty from `other_party_name`, the topic as `Re: Quote #<quote_id>` unless `subject` is present, the last message preview, unread count, and updated date. Do not show internal user ids or invent an email-style subject.

list_inbox_conversations

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier addresses. Use page and limit to page through large result sets. Requires supplier-profile:read.

list_supplier_addresses

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier capacity. Use page and limit to page through large result sets. Requires supplier-profile:read.

list_supplier_capacity

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier catalogs. Use page and limit to page through large result sets. Requires supplier-media:read.

list_supplier_catalogs

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. List coop quote requests sent to the authenticated supplier only, with supplier-facing statuses. Supports under_review and closed. Requires supplier OAuth context and quote-requests:read or quote-requests:write.

list_supplier_coop_quote_requests

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier links. Use page and limit to page through large result sets. Requires supplier-media:read.

list_supplier_links

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List reference options needed for supplier profile updates. Use kind='keywords' for dashboard keyword/category options, kind='certifications' for supplier certifications, kind='nigp_codes' for capacity rows, kind='states' for states, or kind='all' for a combined lookup. Keywords are returned as city_services because that is the API field name. Use q to search within the chosen kind. When a user gives NIGP class numbers or names, search with kind='nigp_codes' and q first, then pass the returned nigp_codes[].id to capacity tools. This is supplier-dashboard lookup data, not marketplace directory search. Requires supplier-profile:read or supplier-profile:write.

list_supplier_profile_options

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. List quick quote requests sent to the authenticated supplier only, with supplier-facing statuses. Supports under_review and closed. Requires supplier OAuth context and quote-requests:read or quote-requests:write.

list_supplier_quick_quote_requests

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List reference requests sent by the authenticated supplier, including recipient email, status, related reference id, and timestamps. Verification tokens are never returned. Use page and limit to page through all requests. Requires supplier-references:read or supplier-references:write.

list_supplier_reference_requests

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List references owned by the authenticated supplier with reviewer details, ratings, visibility, timestamps, and review text. Use page and limit to page through all references. Requires supplier-references:read or supplier-references:write.

list_supplier_references

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List the Signals opportunities matched to the authenticated supplier, newest meeting first. Each signal has its id, government entity, contact, meeting date, description, estimated amount, matching contracts, the meeting video link with a timestamp, and the supplier's status (new, viewed, contacted, or not_relevant). Read-only: it cannot change a signal's status or contact anyone. Use page and limit to page through results. Requires supplier-signals:read.

list_supplier_signals

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier solicitations. Use page and limit to page through large result sets. Requires supplier-solicitations:read.

list_supplier_solicitations

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier team invites. Use page and limit to page through large result sets. Requires team:read.

list_supplier_team_invites

Available only to authenticated supplier users. These tools operate on quote requests and team data for the authenticated supplier only. List team members for the authenticated supplier only. Use page and limit to page through large teams. Show names, emails, role, primary/current flags, and do not show internal user ids. Requires team:read.

list_supplier_team_members

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. List supplier videos. Use page and limit to page through large result sets. Requires supplier-media:read.

list_supplier_videos

Advance the authenticated agency or supplier user's read cursor for one Civic Marketplace inbox conversation. Requires inbox:write.

mark_inbox_conversation_read

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Register intent to bid on one solicitation as the authenticated supplier. This may notify the solicitation owner by email. Requires supplier-solicitations:write.

register_supplier_solicitation_intent

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Remove NIGP capacity categories from the authenticated supplier without changing other capacity rows. Use list_supplier_capacity to see current internal NIGP ids. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

remove_supplier_capacity_nigp_codes

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Remove certifications from the authenticated supplier without changing other certifications. Use list_supplier_profile_options with kind='certifications' if ids are unclear. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

remove_supplier_certifications

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Remove dashboard keyword/category options from the authenticated supplier without changing other keywords. Use list_supplier_profile_options with kind='keywords' if ids are unclear. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

remove_supplier_keywords

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Remove a supplier team member by email. Requires team:write and supplier admin access.

remove_supplier_team_member

Reply to one Civic Marketplace inbox conversation for the authenticated agency or supplier. The recipient may also receive a delayed email notification. Attachments must be existing S3 metadata; this tool does not upload files. Requires inbox:write.

send_inbox_message

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Send a supplier reference request by email to one external recipient. Requires supplier-references:write.

send_supplier_reference_request

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Replace the full supplier capacity list. Use internal nigp_code_id values returned by list_supplier_profile_options with kind='nigp_codes', not NIGP class numbers like 204 or 208. For service rows, order quantity and unit fields are ignored. For normal user requests to add/remove NIGP categories, prefer add_supplier_capacity_nigp_codes or remove_supplier_capacity_nigp_codes. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

set_supplier_capacity

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Set supplier primary address. Requires the matching supplier dashboard write scope. Changes may be visible on the public Civic Marketplace supplier profile.

set_supplier_primary_address

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Replace supplier keywords and/or certification relationships. Keywords are called city_service_ids in the API. Omit a field to leave that relationship unchanged. For normal user requests to add or remove keywords/categories/certifications, prefer add_supplier_keywords, remove_supplier_keywords, add_supplier_certifications, or remove_supplier_certifications. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

set_supplier_services_certifications

Available only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Replace the full set of states served for the authenticated supplier. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.

set_supplier_states_served