Federal Grant Evidence
Find U.S. federal grants and return cited hard-gate and award-history evidence packs.
我该使用它吗
质量与安全性
发现(2)
- LOW在 get_federal_grant_evidence_pack 中
- LOW在 submit_federal_grant_profile_v2_beta 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"federal-grant-evidence": {
"url": "https://utilityhouse.xyz/mcp"
}
}
}远程端点
https://utilityhouse.xyz/mcpstreamable-http它能做什么
工具清单
工具(7)
🟢get_grant_document_manifest(opportunity_id)
Use this when the user needs to know which official documents a U.S. federal grant opportunity has, which revision is current, and whether the official record is complete. It returns every Full Announcement, revised announcement, supporting document and application package Grants.gov holds, with official download URLs. It does not read the documents, assess eligibility, predict an award, draft, or submit.
输入模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string",
"description": "Official Grants.gov opportunity ID, for example 332894",
"pattern": "^[0-9]{4,12}$",
"minLength": 4,
"maxLength": 12
}
},
"required": [
"opportunity_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string"
},
"opportunity_number": {
"type": "string"
},
"revision": {
"type": [
"integer",
"null"
]
},
"latest_history_revision": {
"type": [
"integer",
"null"
]
},
"completeness": {
"type": "string",
"enum": [
"COMPLETE",
"PARTIAL",
"UNKNOWN"
]
},
"reason_codes": {
"type": "array",
"items": {
"type": "string"
}
},
"documents": {
"type": "array"
},
"linked_documents": {
"type": "array"
},
"packages": {
"type": "array"
},
"collected_evidence": {
"type": [
"object",
"null"
]
}
},
"required": [
"opportunity_id",
"revision",
"completeness",
"documents"
]
}🟢analyze_nofo_requirements(opportunity_id, claim_types)
Use this after the document manifest, when the user needs the requirements stated inside a U.S. federal grant's official announcement — eligibility, cost share, deadlines, page limits, required submissions and evaluation criteria — each with the document, page and exact source text it came from. It returns CONFIRMED, CONFLICT, UNKNOWN or EXTRACTION_INCOMPLETE per requirement and never fills a gap with an inference. It does not determine legal eligibility, predict an award, draft, or submit.
输入模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string",
"description": "Official Grants.gov opportunity ID, for example 332894",
"pattern": "^[0-9]{4,12}$",
"minLength": 4,
"maxLength": 12
},
"claim_types": {
"type": "array",
"description": "Optional filter; omit for every requirement class.",
"items": {
"type": "string"
},
"maxItems": 15
}
},
"required": [
"opportunity_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"EVIDENCE_NOT_COLLECTED",
"EVIDENCE_STORE_NOT_READY",
"STALE_REVISION",
"COLLECTED"
]
},
"snapshot_id": {
"type": "string"
},
"revision": {
"type": [
"integer",
"null"
]
},
"observed_at": {
"type": "string"
},
"manifest_completeness": {
"type": "string"
},
"coverage": {
"type": "object"
},
"unread_documents": {
"type": "array",
"items": {
"type": "object"
}
},
"claims": {
"type": "array",
"items": {
"type": "object"
}
},
"detail": {
"type": "string"
}
},
"required": [
"opportunity_id",
"state"
]
}🟡compare_grant_amendments(opportunity_id, since_revision)
Use this when the user needs to know what changed between revisions of a U.S. federal grant opportunity — deadlines, cost share, eligibility, funding — with the before and after value for each change and how much it matters. It reads the official revision history and reports what Grants.gov itself declared changed alongside the computed difference. It does not read announcement documents, assess eligibility, predict an award, draft, or submit.
输入模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string",
"description": "Official Grants.gov opportunity ID, for example 332894",
"pattern": "^[0-9]{4,12}$",
"minLength": 4,
"maxLength": 12
},
"since_revision": {
"type": "integer",
"minimum": 0,
"description": "Optional; compare only revisions after this one."
}
},
"required": [
"opportunity_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"SINGLE_REVISION",
"HISTORY_UNAVAILABLE",
"PARTIAL_HISTORY",
"COMPARED"
]
},
"current_revision": {
"type": [
"integer",
"null"
]
},
"revisions_observed": {
"type": "array",
"items": {
"type": "integer"
}
},
"pairs_observed": {
"type": "integer"
},
"pairs_compared": {
"type": "integer"
},
"pairs_unavailable": {
"type": "integer"
},
"worst_materiality": {
"type": "string"
},
"unavailable_pairs": {
"type": "array",
"items": {
"type": "object"
}
},
"changes": {
"type": "array",
"items": {
"type": "object"
}
},
"detail": {
"type": "string"
}
},
"required": [
"opportunity_id",
"state",
"current_revision",
"revisions_observed"
]
}🟡search_federal_grants(query, limit)
Use this when the user needs to find current or forecasted U.S. federal grant opportunities by topic. It returns official identifiers and source URLs for follow-up analysis. Do not use it to decide eligibility, predict an award, write an application, or submit anything.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Topic or phrase such as community oral health",
"minLength": 2,
"maxLength": 120
},
"limit": {
"type": "integer",
"description": "Maximum results, from 1 to 20",
"minimum": 1,
"maximum": 20,
"default": 8
}
},
"required": [
"query"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"count": {
"type": "integer"
},
"opportunities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"number": {
"type": "string"
},
"title": {
"type": "string"
},
"agency": {
"type": "string"
},
"closeDate": {
"type": "string"
},
"status": {
"type": "string"
},
"sourceUrl": {
"type": "string"
}
},
"required": [
"id",
"number",
"title",
"agency",
"closeDate",
"status",
"sourceUrl"
]
}
},
"sourceFreshness": {
"type": "object"
}
},
"required": [
"query",
"count",
"opportunities",
"sourceFreshness"
]
}🟢analyze_federal_grant(opportunity_id, organization)
Use this when the user needs a sourced go/no-go pursuit screen for one U.S. federal grant using a non-personal organization profile and the official opportunity record. The current preview is always free and explicitly marks unresolved project relevance, document, or award-history evidence. Do not use it for discovery only, legal eligibility advice, award prediction, drafting, or submission.
输入模式
{
"type": "object",
"properties": {
"opportunity_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Numeric Grants.gov opportunity id from search_federal_grants"
},
"organization": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"state_government",
"county_government",
"city_or_township_government",
"special_district_government",
"independent_school_district",
"public_higher_education",
"federally_recognized_tribal_government",
"public_housing_authority",
"tribal_organization",
"nonprofit_501c3",
"nonprofit_without_501c3",
"private_higher_education",
"for_profit_organization",
"small_business",
"other"
]
},
"state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "US"
},
"requested_amount_usd": {
"type": "number",
"minimum": 0
},
"can_meet_cost_share": {
"type": "boolean"
}
},
"required": [
"entity_type",
"state"
],
"additionalProperties": false
}
},
"required": [
"opportunity_id",
"organization"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"type": "string"
},
"chargeable": {
"type": "boolean"
},
"resultCompleteness": {
"type": "string",
"enum": [
"OFFICIAL_RECORD_PREVIEW",
"OFFICIAL_PLUS_AWARD_HISTORY_PREVIEW"
]
},
"recommendation": {
"type": "string",
"enum": [
"CONDITIONAL",
"NO_GO"
]
},
"reasonCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"opportunity": {
"type": "object"
},
"organization": {
"type": "object"
},
"hardGates": {
"type": "array",
"items": {
"type": "object"
}
},
"productRelevance": {
"type": "object"
},
"funding": {
"type": "object"
},
"programs": {
"type": "array",
"items": {
"type": "object"
}
},
"unresolved": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "array",
"items": {
"type": "object"
}
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"officialRecordFreshness": {
"type": "object"
}
},
"required": [
"schemaVersion",
"chargeable",
"resultCompleteness",
"recommendation",
"reasonCodes",
"opportunity",
"organization",
"hardGates",
"productRelevance",
"funding",
"programs",
"unresolved",
"sources",
"limitations",
"officialRecordFreshness"
]
}🟢get_federal_grant_evidence_pack(request_id, opportunity_id, organization)
Use this limited free-beta tool after search or preview when the user wants a complete, versioned hard-gate and award-history evidence pack for one U.S. federal grant. It never requests payment during the beta. The service has a global daily beta capacity and counts only newly released complete results; reuse request_id for retries. It does not evaluate semantic project relevance, determine legal eligibility, predict an award, draft, or submit.
输入模式
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{16,160}$",
"description": "Caller-generated stable idempotency key; reuse it for retries"
},
"opportunity_id": {
"type": "string",
"pattern": "^\\d{1,12}$",
"description": "Numeric Grants.gov opportunity id"
},
"organization": {
"type": "object",
"properties": {
"entity_type": {
"type": "string",
"enum": [
"state_government",
"county_government",
"city_or_township_government",
"special_district_government",
"independent_school_district",
"public_higher_education",
"federally_recognized_tribal_government",
"public_housing_authority",
"tribal_organization",
"nonprofit_501c3",
"nonprofit_without_501c3",
"private_higher_education",
"for_profit_organization",
"small_business",
"other"
]
},
"state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"default": "US"
},
"requested_amount_usd": {
"type": "number",
"minimum": 1
},
"can_meet_cost_share": {
"type": "boolean"
}
},
"required": [
"entity_type",
"state",
"requested_amount_usd",
"can_meet_cost_share"
],
"additionalProperties": false
}
},
"required": [
"request_id",
"opportunity_id",
"organization"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"type": "string",
"const": "1.0"
},
"chargeable": {
"type": "boolean"
},
"resultCompleteness": {
"type": "string",
"const": "COMPLETE_WITHIN_DECLARED_SCOPE"
},
"scope": {
"type": "object"
},
"opportunity": {
"type": "object"
},
"organization": {
"type": "object"
},
"recommendation": {
"type": "string"
},
"reasonCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"hardGates": {
"type": "array",
"items": {
"type": "object"
}
},
"funding": {
"type": "object"
},
"programs": {
"type": "array",
"items": {
"type": "object"
}
},
"provenance": {
"type": "object"
},
"billing": {
"type": "object"
},
"limitations": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schemaVersion",
"chargeable",
"resultCompleteness",
"scope",
"opportunity",
"organization",
"recommendation",
"reasonCodes",
"hardGates",
"funding",
"programs",
"provenance",
"billing",
"limitations"
]
}🟡submit_federal_grant_profile_v2_beta(request_id, opportunity_id, profile, attest_current_actual_non_personal_facts, attest_intends_to_apply_to_opportunity_359701, ...)
Use this opt-in free-beta tool only when the user wants to test opportunity 359701 against current actual non-personal organization, project, and readiness facts. The user must explicitly attest that the facts are current, explicitly confirm intent to apply to this opportunity, and consent to storing the resulting pointer-only pack for 30 days. The raw profile, names, contact details, identifiers, narratives, documents, and credentials are not stored. Missing facts remain NEEDS_INPUT. It does not determine legal eligibility, predict an award, draft, or submit an application.
输入模式
{
"type": "object",
"properties": {
"request_id": {
"type": "string",
"format": "uuid",
"description": "Caller-generated UUID used only for idempotent replay"
},
"opportunity_id": {
"type": "string",
"const": "359701"
},
"profile": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "2.0"
},
"organization": {
"type": "object",
"properties": {
"entity_type": {
"type": "string"
},
"legal_domicile": {
"$ref": "#/$defs/location"
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"enum": [
"FISHING_OR_MARITIME_INVOLVEMENT",
"FISHING_OR_MARITIME_EXPERTISE",
"PUBLIC_HEALTH_AUTHORITY",
"CONSTITUTIONAL_PUBLIC_HEALTH_AUTHORITY",
"ACADEMIC_OCCUPATIONAL_SAFETY_HEALTH_CENTER",
"MULTI_PROJECT_PROGRAM_CAPACITY",
"RESEARCH_FACILITY_CONSTRUCTION_CAPACITY"
]
},
"uniqueItems": true,
"maxItems": 16
},
"public_health_jurisdiction": {
"type": "object",
"properties": {
"authority_confirmed": {
"type": "boolean"
},
"constitutional_authority_confirmed": {
"type": "boolean"
},
"population": {
"type": "integer",
"minimum": 0
},
"attachment_a_listed": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"required": [
"entity_type",
"legal_domicile"
],
"additionalProperties": false
},
"project": {
"type": "object",
"properties": {
"requested_amount_usd": {
"type": "number",
"minimum": 0
},
"total_cost_usd": {
"type": "number",
"minimum": 0
},
"requested_federal_amount_per_budget_period_usd": {
"type": "number",
"minimum": 0
},
"requested_federal_amount_project_total_usd": {
"type": "number",
"minimum": 0
},
"duration_months": {
"type": "integer",
"minimum": 1,
"maximum": 1200
},
"committed_cost_share_percent": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"project_kinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"RESEARCH",
"PUBLIC_HEALTH_RESPONSE",
"FAMILY_PLANNING_SERVICES",
"RESEARCH_FACILITY_CONSTRUCTION",
"RESEARCH_FACILITY_MODERNIZATION",
"EDUCATION_AND_RESEARCH_CENTER"
]
},
"uniqueItems": true,
"maxItems": 12
},
"performance_sites": {
"type": "array",
"items": {
"$ref": "#/$defs/location"
},
"maxItems": 300
},
"affected_areas": {
"type": "array",
"items": {
"$ref": "#/$defs/location"
},
"maxItems": 300
},
"service_areas": {
"type": "array",
"items": {
"$ref": "#/$defs/location"
},
"maxItems": 300
},
"has_foreign_components": {
"type": "boolean"
},
"has_foreign_collaborators": {
"type": "boolean"
},
"collects_public_health_data": {
"type": "boolean"
},
"involves_human_subjects": {
"type": "boolean"
},
"multi_institution_human_subjects_research": {
"type": "boolean"
},
"involves_clinical_trial": {
"type": "boolean"
},
"involves_research": {
"type": "boolean"
},
"requests_indirect_costs": {
"type": "boolean"
},
"has_non_federal_financial_support": {
"type": "boolean"
}
},
"additionalProperties": false
},
"readiness": {
"type": "object",
"properties": {
"application_count_for_institution": {
"type": "integer",
"minimum": 0
},
"application_count_for_same_project": {
"type": "integer",
"minimum": 0
},
"registrations": {
"type": "object",
"properties": {
"SAM": {
"type": "boolean"
},
"UEI": {
"type": "boolean"
},
"GRANTS_GOV": {
"type": "boolean"
},
"ERA_COMMONS": {
"type": "boolean"
}
},
"additionalProperties": false
},
"current_award_mechanisms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"uniqueItems": true,
"maxItems": 40
},
"current_application_mechanisms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"uniqueItems": true,
"maxItems": 40
},
"prepared_submission_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"uniqueItems": true,
"maxItems": 200
},
"component_form_readiness": {
"type": "array",
"maxItems": 30,
"items": {
"type": "object",
"properties": {
"component_type": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"instance_count": {
"type": "integer",
"minimum": 0,
"maximum": 20
},
"prepared_form_ids": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"uniqueItems": true,
"maxItems": 30
}
},
"required": [
"component_type",
"instance_count",
"prepared_form_ids"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"required": [
"schema_version",
"organization",
"project",
"readiness"
],
"additionalProperties": false,
"$defs": {
"location": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"subdivision_code": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,12}$"
},
"county_name": {
"type": "string",
"maxLength": 120
},
"municipality_name": {
"type": "string",
"maxLength": 120
}
},
"required": [
"country_code"
],
"additionalProperties": false
}
}
},
"attest_current_actual_non_personal_facts": {
"type": "boolean",
"const": true
},
"attest_intends_to_apply_to_opportunity_359701": {
"type": "boolean",
"const": true
},
"consent_to_store_pointer_only_result": {
"type": "boolean",
"const": true
}
},
"required": [
"request_id",
"opportunity_id",
"profile",
"attest_current_actual_non_personal_facts",
"attest_intends_to_apply_to_opportunity_359701",
"consent_to_store_pointer_only_result"
],
"additionalProperties": false,
"$defs": {
"location": {
"type": "object",
"properties": {
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"subdivision_code": {
"type": "string",
"pattern": "^[A-Za-z0-9-]{1,12}$"
},
"county_name": {
"type": "string",
"maxLength": 120
},
"municipality_name": {
"type": "string",
"maxLength": 120
}
},
"required": [
"country_code"
],
"additionalProperties": false
}
}
}输出模式
{
"type": "object",
"properties": {
"schemaVersion": {
"type": "string",
"const": "1.0-beta-profile-proof"
},
"stored": {
"type": "boolean"
},
"storageDisposition": {
"type": "string"
},
"profileInputStored": {
"type": "boolean",
"const": false
},
"proof": {
"type": "object"
},
"pack": {
"type": "object"
}
},
"required": [
"schemaVersion",
"stored",
"storageDisposition",
"profileInputStored",
"pack"
]
}社区
证据