add_supplier_address
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add an address to the authenticated supplier profile. Making it primary may replace the current primary address. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
add_supplier_capacity_nigp_codes
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add NIGP capacity categories to the authenticated supplier without removing existing capacity rows. Use list_supplier_profile_options with kind='nigp_codes' to find internal ids first; do not pass NIGP class numbers. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
add_supplier_catalog
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add existing S3 catalog metadata to the authenticated supplier. This tool does not upload binary files. Requires supplier-media:write. Changes may be visible on the public Civic Marketplace supplier profile.
add_supplier_certifications
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add certifications to the authenticated supplier without removing existing certifications. Use list_supplier_profile_options with kind='certifications' to find ids first. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
add_supplier_keywords
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add dashboard keyword/category options to the authenticated supplier without removing existing keywords. Use list_supplier_profile_options with kind='keywords' to find ids first. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
add_supplier_video
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add a video entry to the authenticated supplier dashboard. Requires supplier-media:write. Changes may be visible on the public Civic Marketplace supplier profile.
archive_coop_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Archive selected coop quote quote requests without changing their lifecycle status. Archiving is reversible; permanently closed requests cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
archive_quick_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Archive selected quick quote quote requests without changing their lifecycle status. Archiving is reversible; permanently closed requests cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
ask_supplier_solicitation_question
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Ask a question on one solicitation as the authenticated supplier. This may notify the solicitation owner by email. Requires supplier-solicitations:write. Tool documentation: https://docs.civicmarketplace.com/ai-connector/tools-and-permissions
bulk_create_coop_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. Create multiple direct cooperative contract quote requests from CSV text. The agency is inherited from the authenticated caller. Deadlines accept YYYY-MM-DD or ISO 8601 timestamps with an offset, must be at least three US business days away, and must fall on a business day. Date-only deadlines use 17:00; an omitted deadline_timezone uses America/Chicago. The API validates every row before creating anything. CSV headers: contract_id, quotes_deadline, deadline_timezone, specifications, plus supplier_ids or suppliers. deadline_timezone is optional and accepts an IANA identifier such as America/New_York. Supplier IDs must be on the contract.
bulk_create_quick_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. Create multiple quick quote requests from CSV text. The agency is inherited from the authenticated caller. Deadlines accept YYYY-MM-DD or ISO 8601 timestamps with an offset, must be at least three US business days away, and must fall on a business day. Date-only deadlines use 17:00; an omitted deadline_timezone uses America/Chicago. The API validates every row before creating anything; if any row is invalid, no requests are created. CSV headers: quotes_deadline, deadline_timezone, specifications, plus supplier_ids or suppliers, plus nigp_code_ids or nigp_codes. deadline_timezone is optional and accepts an IANA identifier such as America/New_York. Use semicolon, comma, or pipe within supplier/nigp cells.
cancel_coop_quote_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Cancel one waiting coop quote request by closing it. Requires quote-requests:write and management permission for the request.
cancel_quick_quote_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Cancel one waiting quick quote request by closing it. Requires quote-requests:write and management permission for the request.
change_coop_quote_owner
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Change ownership for one coop quote request. Prefer new_owner_email from list_agency_users when the caller chooses a colleague by name; new_owner_agency_user_id is supported for backwards compatibility but should not be shown to end users. Agency admins can take over or assign; regular users can hand over only their own requests. Requires quote-requests:write.
change_quick_quote_owner
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Change ownership for one quick quote request. Prefer new_owner_email from list_agency_users when the caller chooses a colleague by name; new_owner_agency_user_id is supported for backwards compatibility but should not be shown to end users. Agency admins can take over or assign; regular users can hand over only their own requests. Requires quote-requests:write.
close_coop_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Permanently close selected coop quote requests. Closed requests are terminal and cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
close_quick_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Permanently close selected quick quote requests. Closed requests are terminal and cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
count_contracts
ChatGPTReturn only the number of Civic Marketplace contracts matching the supplied filters. Intended for explicit count or total requests; no contract rows are returned.
count_suppliers
ChatGPTReturn only the number of Civic Marketplace suppliers matching the supplied filters. Intended for explicit count or total requests; no supplier rows are returned.
create_coop_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. Create a direct cooperative contract quote request for the authenticated caller's agency. This sends the request to selected suppliers already linked to the contract. Notifications may be sent by email, and configured CRM or analytics integrations may be updated. The agency is inherited from the caller and cannot be supplied by the client. The agency, contract, and suppliers must be in the caller's partner scope, and every supplier must be on the contract and active on it this quarter; list them with list_coop_quote_suppliers. The caller must be a member of the agency. Ask one question at a time, in this order. Never invent an answer for the buyer, and never create a request until the buyer has explicitly confirmed the review. Follow these steps: 1. Which contract? Find it with search_contracts or get_contract. 2. Quotes deadline as a date (YYYY-MM-DD) with its timezone, defaulting to America/Chicago. It must be at least three US business days away and fall on a business day. 3. Suppliers. Call list_coop_quote_suppliers for the contract and choose at least one. Only suppliers active on the contract this quarter can be invited. 4. Specifications, at least 10 characters. 5. Review. Summarise the contract, deadline, suppliers and specifications, and call create_coop_request only after the buyer explicitly confirms. V1 does not create white-glove requests or attachments.
create_quick_quote_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. Create a Civic Marketplace Quick Quote request for the authenticated caller's agency. Ask one question at a time, in this order. Never invent an answer for the buyer, and never create a request until the buyer has explicitly confirmed the review. Follow these steps: 1. What do you need? Ask in the buyer's own words, then call search_quick_quote_suppliers with need. 2. Quotes deadline. Offer High (quotes in 1 to 2 business days, a reason is required), Standard (3 to 5 business days) or a specific date. A date must be at least three US business days away and fall on a business day; ask for the timezone and default to America/Chicago. Send deadline_priority OR quotes_deadline, never both. 3. Suppliers. List every match, local suppliers first, all selected unless the buyer removes some. Offer "Find more suppliers for me" (cm_sourcing_requested): on by default when there are fewer than 3 matches, and required when there are none. 4. Specifications, at least 10 characters. Attachments can be added later on the web. 5. Review. Summarise the need, deadline, suppliers, sourcing choice and specifications, and call create_quick_quote_request only after the buyer explicitly confirms. The deadline is either a priority (deadline_priority, computed from the moment of submission) or a specific quotes_deadline that is at least three US business days away on a business day, with date-only values at 17:00 in deadline_timezone (default America/Chicago). Provide nigp_code_ids or search_query. supplier_ids may be empty only when cm_sourcing_requested is true. The request is sent to the selected eligible suppliers only, so prefer suppliers flagged is_local by search_quick_quote_suppliers when the agency prefers local suppliers. The response names the entity and how many invited suppliers are local. It may trigger email, CRM, or analytics updates.
decline_supplier_coop_quote
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Decline one coop quote request sent to the authenticated supplier. This may send email notifications and update configured CRM or analytics integrations. Requires quote-requests:write.
decline_supplier_quick_quote
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Decline one quick quote request sent to the authenticated supplier. This may send email notifications and update configured CRM or analytics integrations. Requires quote-requests:write.
delete_supplier_address
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Delete supplier address. Requires the matching supplier dashboard write scope. Changes may be visible on the public Civic Marketplace supplier profile.
delete_supplier_catalog
ChatGPTAvailable 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_link
ChatGPTAvailable 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_video
ChatGPTAvailable 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.
get_contract
ChatGPTReturn full detail for one contract, including its description, value bracket, term dates, status, suppliers, cooperative, lead entity, city services, NIGP codes, and associated document metadata. document_read_available tells you whether document IDs can be read through this MCP connection. Returns a permission message when the caller's entity is not authorised to view the contract.
get_coop_quote_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Get one authenticated-agency coop quote request with owner, status, suppliers, and response counts. Requires quote-requests:read or quote-requests:write.
get_inbox_messages
ChatGPTRead 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_unread_count
ChatGPTReturn the authenticated agency or supplier user's unread Civic Marketplace inbox conversation count. Requires inbox:read or inbox:write.
get_my_supplier_profile
ChatGPTAvailable 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_quick_quote_request
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Get one authenticated-agency quick quote request with owner, status, suppliers, and response counts. Requires quote-requests:read or quote-requests:write.
get_quote_request_status_summary
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Summarize all quick and coop quote lifecycle states, including under_review and closed. All includes closed requests. Requires quote-requests:read or quote-requests:write.
get_supplier
ChatGPTFull profile for one supplier: name, intro/about description, location, address, states served, phone, email, website, social links, certifications (HUB/WOSB/SDVOSB/etc.), verification status, and a deep-link to their CM profile.
get_supplier_analytics_summary
ChatGPTAvailable 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_coop_quote_request
ChatGPTAvailable 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_quick_quote_request
ChatGPTAvailable 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_quote_request_status_summary
ChatGPTAvailable 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_reference
ChatGPTAvailable 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_solicitation
ChatGPTAvailable 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.
invite_supplier_team_member
ChatGPTAvailable 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.
list_agency_users
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. List agency colleagues eligible to own a quote request, with name, role, and email but without internal agency-user IDs. Supports search and pagination. Requires quote-requests:read or quote-requests:write.
list_certifications
ChatGPTList certifications suppliers can hold, including SBE/diversity certifications such as DBE, MBE, HUB, and WOSB, and technical certifications such as ISO 37001, AZ-104, and A+. Supports search by name or abbreviation and filtering by the sbe or technical family. Results include the abbreviation and name accepted by supplier certification filters.
list_city_services
ChatGPTList service categories used to classify contracts (e.g. IT, Fleet). Use returned IDs as the city_service filter on search_contracts and search_suppliers. Results are cached briefly server-side.
list_coop_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. List the authenticated agency's coop quote requests with status counts. Supports all lifecycle states including under_review and closed; without a status filter, includes closed requests. Requires quote-requests:read or quote-requests:write.
list_coop_quote_suppliers
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. List the suppliers on a cooperative contract that can be invited to a coop quote: visible to buyers and active on the contract this quarter. Returns the numeric supplier IDs required by create_coop_request. 1. Which contract? Find it with search_contracts or get_contract. 2. Quotes deadline as a date (YYYY-MM-DD) with its timezone, defaulting to America/Chicago. It must be at least three US business days away and fall on a business day. 3. Suppliers. Call list_coop_quote_suppliers for the contract and choose at least one. Only suppliers active on the contract this quarter can be invited. 4. Specifications, at least 10 characters. 5. Review. Summarise the contract, deadline, suppliers and specifications, and call create_coop_request only after the buyer explicitly confirms.
list_coops
ChatGPTList purchasing cooperatives whose contracts are accessible. Use returned IDs as the coop filter on search_contracts. Results are cached briefly server-side.
list_inbox_conversations
ChatGPTList 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_lead_entities
ChatGPTList lead entities (cities, counties, agencies) that own contracts. Use returned IDs as the lead_entity filter on search_contracts. Results are cached briefly server-side.
list_my_team_members
ChatGPTList the authenticated user's team members. Supplier sessions return supplier teammates; agency sessions return agency colleagues eligible for quote ownership. Requires team:read for suppliers or quote-requests:read/write for agencies.
list_quick_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. List the authenticated agency's quick quote requests with status counts. Supports all lifecycle states including under_review and closed; without a status filter, includes closed requests. Requires quote-requests:read or quote-requests:write.
list_supplier_addresses
ChatGPTAvailable 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_capacity
ChatGPTAvailable 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_catalogs
ChatGPTAvailable 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_coop_quote_requests
ChatGPTAvailable 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_links
ChatGPTAvailable 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_profile_options
ChatGPTAvailable 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_quick_quote_requests
ChatGPTAvailable 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_reference_requests
ChatGPTAvailable 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_references
ChatGPTAvailable 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_signals
ChatGPTAvailable 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_solicitations
ChatGPTAvailable 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_team_invites
ChatGPTAvailable 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_members
ChatGPTAvailable 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_videos
ChatGPTAvailable 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.
mark_inbox_conversation_read
ChatGPTAdvance the authenticated agency or supplier user's read cursor for one Civic Marketplace inbox conversation. Requires inbox:write.
read_contract_document
ChatGPTReturn an extracted text chunk from one authorised contract document, such as a pricing sheet, RFP, or master service agreement. Inputs use the contract ID and document_id exposed in contract details. Supported formats are PDF, XLSX, CSV, and plain text; image-only PDFs and legacy .doc/.xls files return an unsupported-format error. Long documents return next_offset for pagination. Only public documentation on contracts visible to the caller's entity can be read.
read_external_contract_document
ChatGPTDownload and extract a text chunk from an approved external procurement URL returned by Civic Marketplace external search. Arbitrary URLs outside the configured source inventory are rejected. Supported content is PDF, HTML, and plain text. PDF responses include one-based physical page markers; long documents return next_offset, and extraction_truncated reports incomplete extraction. Returned content is labelled as external, untrusted, and unverified. Tool documentation: https://docs.civicmarketplace.com/ai-connector/tools-and-permissions
register_supplier_solicitation_intent
ChatGPTAvailable 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.
remove_supplier_capacity_nigp_codes
ChatGPTAvailable 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_certifications
ChatGPTAvailable 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_keywords
ChatGPTAvailable 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_team_member
ChatGPTAvailable 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.
search_contracts
ChatGPTSearch Civic Marketplace contracts by keyword, cooperative, supplier, service category, or update time. Each result includes the contract name, supplier names, lead entity, cooperative, short summary, and Civic Marketplace deep-link.
search_external_contracts
ChatGPTSearch Civic Marketplace's approved external public-procurement source inventory for cooperative contracts. Intended for requests that explicitly include external public sources or when Civic Marketplace has no matching contract. Each result includes its source, public link, title, and snippet, and is labelled as external and unverified.
search_nigp_codes
ChatGPTSearch Civic Marketplace NIGP categories by plain-language purchasing need or NIGP class number. Results include numeric internal IDs and canonical zero-padded class strings suitable for purchasing-category selection. Example queries include 'computer software', 'janitorial', 'fleet repair', and '00505'. Use a few focused or broader queries and reuse their results; do not fan out hundreds of parallel searches. If rate-limited, honor the retry delay before making another call.
search_quick_quote_suppliers
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot create buyer-side quote requests. Find suppliers the authenticated agency is allowed to invite to a Quick Quote. This eligibility-scoped lookup takes need (what the buyer is looking for, in their own words) on its own, or a supplier-name query and internal NIGP IDs instead, and returns the numeric supplier IDs required by Quick Quote creation. Use need for step 1 of creating a Quick Quote: 1. What do you need? Ask in the buyer's own words, then call search_quick_quote_suppliers with need. 2. Quotes deadline. Offer High (quotes in 1 to 2 business days, a reason is required), Standard (3 to 5 business days) or a specific date. A date must be at least three US business days away and fall on a business day; ask for the timezone and default to America/Chicago. Send deadline_priority OR quotes_deadline, never both. 3. Suppliers. List every match, local suppliers first, all selected unless the buyer removes some. Offer "Find more suppliers for me" (cm_sourcing_requested): on by default when there are fewer than 3 matches, and required when there are none. 4. Specifications, at least 10 characters. Attachments can be added later on the web. 5. Review. Summarise the need, deadline, suppliers, sourcing choice and specifications, and call create_quick_quote_request only after the buyer explicitly confirms. For agencies that prefer local suppliers, local suppliers are listed first and flagged is_local, meaning the supplier is local to the buyer's entity.
search_suppliers
ChatGPTSearch the general Civic Marketplace supplier directory by capability, state, certification, service category, or update time. This directory search is not scoped to Quick Quote eligibility. Each result includes the supplier name, location, states served, a capped certification preview, website, and Civic Marketplace deep-link. All supplied filters combine with AND; comma-separated certification values require every listed certification.
send_inbox_message
ChatGPTReply 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_supplier_reference_request
ChatGPTAvailable 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.
set_supplier_capacity
ChatGPTAvailable 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_primary_address
ChatGPTAvailable 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_services_certifications
ChatGPTAvailable 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_states_served
ChatGPTAvailable 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.
submit_supplier_coop_quote
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Submit a response for one coop quote request sent to the authenticated supplier. This may send email notifications and update configured CRM or analytics integrations. Requires quote-requests:write. Attachment fields must reference existing S3 metadata.
submit_supplier_quick_quote
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Submit a response for one quick quote request sent to the authenticated supplier. This may send email notifications and update configured CRM or analytics integrations. Requires quote-requests:write. Attachment fields must reference existing S3 metadata.
unarchive_coop_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Restore selected coop quote quote requests without changing their lifecycle status. Archiving is reversible; permanently closed requests cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
unarchive_quick_quote_requests
ChatGPTAvailable only to authenticated agency users; supplier sessions cannot use this agency workflow. Restore selected quick quote quote requests without changing their lifecycle status. Archiving is reversible; permanently closed requests cannot be restored. Agency admins can affect any request in the agency; regular users can affect only their own. Requires quote-requests:write.
update_my_supplier_profile
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Update top-level supplier dashboard profile fields. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
update_supplier_address
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Update one address owned by the authenticated supplier. Making it primary may replace the current primary address. Requires supplier-profile:write. Changes may be visible on the public Civic Marketplace supplier profile.
update_supplier_team_member_role
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Change a supplier team member role to admin or regular by email. Requires team:write and supplier admin access.
upsert_supplier_link
ChatGPTAvailable only to authenticated supplier users and always scoped to the authenticated supplier; supplier_id is not accepted. Add or update a supplier dashboard link. Supplying an existing id replaces that link. Requires supplier-media:write. Changes may be visible on the public Civic Marketplace supplier profile. Tool documentation: https://docs.civicmarketplace.com/ai-connector/tools-and-permissions
add_supplier_address
Claudeadd_supplier_capacity_nigp_codes
Claudeadd_supplier_catalog
Claudeadd_supplier_certifications
Claudeadd_supplier_keywords
Claudeadd_supplier_video
Claudearchive_coop_quote_requests
Claudearchive_quick_quote_requests
Claudeask_supplier_solicitation_question
Claudebulk_create_coop_requests
Claudebulk_create_quick_quote_requests
Claudecancel_coop_quote_request
Claudecancel_quick_quote_request
Claudechange_coop_quote_owner
Claudechange_quick_quote_owner
Claudeclose_coop_quote_requests
Claudeclose_quick_quote_requests
Claudecount_contracts
Claudecount_suppliers
Claudecreate_coop_request
Claudecreate_quick_quote_request
Claudedecline_supplier_coop_quote
Claudedecline_supplier_quick_quote
Claudedelete_supplier_address
Claudedelete_supplier_catalog
Claudedelete_supplier_link
Claudedelete_supplier_video
Claudeget_contract
Claudeget_coop_quote_request
Claudeget_inbox_messages
Claudeget_inbox_unread_count
Claudeget_my_supplier_profile
Claudeget_quick_quote_request
Claudeget_quote_request_status_summary
Claudeget_supplier
Claudeget_supplier_analytics_summary
Claudeget_supplier_coop_quote_request
Claudeget_supplier_quick_quote_request
Claudeget_supplier_quote_request_status_summary
Claudeget_supplier_reference
Claudeget_supplier_solicitation
Claudeinvite_supplier_team_member
Claudelist_agency_users
Claudelist_certifications
Claudelist_city_services
Claudelist_coop_quote_requests
Claudelist_coop_quote_suppliers
Claudelist_coops
Claudelist_inbox_conversations
Claudelist_lead_entities
Claudelist_my_team_members
Claudelist_quick_quote_requests
Claudelist_supplier_addresses
Claudelist_supplier_capacity
Claudelist_supplier_catalogs
Claudelist_supplier_coop_quote_requests
Claudelist_supplier_links
Claudelist_supplier_profile_options
Claudelist_supplier_quick_quote_requests
Claudelist_supplier_reference_requests
Claudelist_supplier_references
Claudelist_supplier_signals
Claudelist_supplier_solicitations
Claudelist_supplier_team_invites
Claudelist_supplier_team_members
Claudelist_supplier_videos
Claudemark_inbox_conversation_read
Clauderead_contract_document
Clauderead_external_contract_document
Clauderegister_supplier_solicitation_intent
Clauderemove_supplier_capacity_nigp_codes
Clauderemove_supplier_certifications
Clauderemove_supplier_keywords
Clauderemove_supplier_team_member
Claudesearch_contracts
Claudesearch_external_contracts
Claudesearch_nigp_codes
Claudesearch_quick_quote_suppliers
Claudesearch_suppliers
Claudesend_inbox_message
Claudesend_supplier_reference_request
Claudeset_supplier_capacity
Claudeset_supplier_primary_address
Claudeset_supplier_services_certifications
Claudeset_supplier_states_served
Claudesubmit_supplier_coop_quote
Claudesubmit_supplier_quick_quote
Claudeunarchive_coop_quote_requests
Claudeunarchive_quick_quote_requests
Claudeupdate_my_supplier_profile
Claudeupdate_supplier_address
Claudeupdate_supplier_team_member_role
Claudeupsert_supplier_link
Claude