Documentation

Everything the gateway exposes.

Authentication, endpoints, the full tool catalogue, and what to do when a call fails. Prefer JSON? Start at /api/catalog.

Authentication

Every request carries a bearer key in the Authorization header. Query-string credentials are not supported: the MCP authorization specification prohibits access tokens in the URI.

Authorization: Bearer YOUR_API_KEY

A missing, malformed, revoked, expired or unknown key returns 401. Going over your rolling 24 hour quota returns a tool error naming the limit.

Quickstart

Three calls and you know the gateway works. Initialize, verify the key, then ask a real question.

1 · Verify the key harbor_meta_ping
# Initialize first and keep the session id (full handshake in the install tab on the home page).
# Then call harbor_meta_ping on the aggregate endpoint. It must return pong.
curl -s https://port.harborgovcon.com/mcp \
  -H "Authorization: Bearer $HARBOR_KEY" \
  -H "Mcp-Session-Id: $SID" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"harbor_meta_ping","arguments":{}}}'
2 · List the servers harbor_meta_list_servers
curl -s https://port.harborgovcon.com/mcp \
  -H "Authorization: Bearer $HARBOR_KEY" \
  -H "Mcp-Session-Id: $SID" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"harbor_meta_list_servers","arguments":{}}}'
3 · Ask a real question usaspending_naics_market_share
curl -s https://port.harborgovcon.com/mcp \
  -H "Authorization: Bearer $HARBOR_KEY" \
  -H "Mcp-Session-Id: $SID" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"usaspending_naics_market_share","arguments":{"naics":"541512","fy":2025,"top_n":5}}}'

Endpoints

EndpointToolsUse it for
https://port.harborgovcon.com/mcp142Everything, one connection
/servers/harbor-meta/mcp4Account & Service Meta
/servers/noaa-cdo/mcp8NOAA Climate Data
/servers/gao-bid-protests/mcp8GAO Bid Protests
/servers/sam-exclusions/mcp5SAM.gov Exclusions
/servers/bea/mcp9Bureau of Economic Analysis
/servers/bls/mcp8Bureau of Labor Statistics
/servers/census/mcp12US Census
/servers/eia/mcp10Energy Information Administration
/servers/usaspending/mcp8USAspending
/servers/sbir-sttr/mcp11SBIR/STTR
/servers/openfda/mcp10openFDA
/servers/sam-contract-awards/mcp6SAM.gov Contract Awards
/servers/sam-entity/mcp6SAM.gov Entity
/servers/sam-federal-hierarchy/mcp4SAM.gov Agency Hierarchy
/servers/sam-opportunities/mcp9SAM.gov Opportunities
/servers/fbi-crime-data/mcp8FBI Crime Data
/servers/federal-register/mcp8Federal Register
/servers/regulations-gov/mcp8Regulations.gov

Server catalogue

Prefer a focused endpoint when you know which dataset you need. The aggregate endpoint loads every tool at once, which costs context and hurts tool selection. Search this page for a tool name to find its server.

Account

Account & Service Meta /servers/harbor-meta/mcp

Verify an API key, check remaining quota, and discover servers. Never touches an upstream API.

list_serverspingquota_statuswhoami
Climate

NOAA Climate Data /servers/noaa-cdo/mcp

Historical climate and weather station data.

climate_normals_for_countydatatypes_for_stationextreme_event_historylocations_for_staterecent_extreme_precip_statestation_search_in_statestation_search_near_zipweather_at_station_during_window
Compliance

GAO Bid Protests /servers/gao-bid-protests/mcp

Bid protest decisions, and how agencies actually get challenged.

protest_decision_pdf_urlprotest_velocity_by_agencyprotests_by_protesterprotests_for_agencyprotests_for_solicitationrecent_sustained_protestssearch_protestssupplements_for
Compliance

SAM.gov Exclusions /servers/sam-exclusions/mcp

Debarment and exclusion records, a compliance gate before any teaming decision.

exclusion_detailexclusions_for_entityexclusions_searchis_excludedrecent_exclusions_by_agency
Economics

Bureau of Economic Analysis /servers/bea/mcp

Regional GDP, personal income, and input-output tables.

county_gdpdiscover_dataset_parametersdiscover_line_codesgdp_by_industryinput_output_matrixlist_datasetsnipa_table_pullpersonal_income_seriesregional_gdp_by_state
Economics

Bureau of Labor Statistics /servers/bls/mcp

Employment, CPI, wages, and state labor-market panels.

cpi_lookupemployment_by_industrylatest_macro_panelseries_data_batchseries_id_resolverstate_unemployment_rateunemployment_lookupwages_by_occupation_geo
Economics

US Census /servers/census/mcp

Market sizing, demographics, business dynamics, and county-level NAICS data.

acs_demographicsbusiness_dynamics_statscbp_market_size_by_naics_countycbp_market_size_by_naics_statecbp_market_size_us_totaldiscover_geographydiscover_variableseconomic_census_pullmedian_household_income_by_statenonemployer_statspopulation_by_statepopulation_estimate_by_state
Energy

Energy Information Administration /servers/eia/mcp

Electricity, natural gas, petroleum prices, and generation capacity.

co2_emissions_statediscover_route_metadataelectricity_retail_price_stateelectricity_retail_price_usgasoline_retail_pricenatural_gas_price_stateoperating_generator_capacitypetroleum_price_seriesrenewable_capacity_by_stateseds_state_series
Federal spending

USAspending /servers/usaspending/mcp

Federal spending: agency spend velocity, incumbent discovery, expiring pipeline.

agency_spend_velocityexpiring_pipelinefind_competitor_awardsincumbent_for_opportunitynaics_market_sharerecipient_corporate_familyresolve_recipient_idtransaction_count_preflight
Funding

SBIR/STTR /servers/sbir-sttr/mcp

Small-business innovation awards and open topics.

dsip_active_solicitation_cyclessbir_award_for_topic_codesbir_award_velocitysbir_awards_by_agencysbir_awards_by_firmsbir_awards_by_keywordsbir_solicitations_opensbir_topic_searchsbir_topics_by_agencysbir_topics_opentopic_metadata_summary
Health

openFDA /servers/openfda/mcp

Drug, device, and recall safety data.

device_510k_clearancesdevice_adverse_eventsdevice_classification_lookupdevice_recalls_recentdrug_adverse_eventsdrug_recalls_recentfood_enforcement_actionsrecall_classification_breakdownsearch_counttotal_hits
Procurement

SAM.gov Contract Awards /servers/sam-contract-awards/mcp

Contract award data (CDAS), the FPDS replacement.

award_by_piidawards_by_agencyawards_by_ueiawards_in_windowrecent_awards_by_naicssetaside_awards
Procurement

SAM.gov Entity /servers/sam-entity/mcp

Entity registration dossiers: the vendor side of the market.

entity_by_cageentity_by_ueientity_dossiernaics_codes_for_entityregistration_statussocioeconomic_status
Procurement

SAM.gov Agency Hierarchy /servers/sam-federal-hierarchy/mcp

Agency and sub-agency codes, the cross-API join key for every other federal dataset.

contracting_offices_undercrosswalk_codesorg_treeresolve_agency
Procurement

SAM.gov Opportunities /servers/sam-opportunities/mcp

The federal procurement firehose: pre-solicitations, solicitations, sources sought, awards.

agency_opportunity_velocityamendments_for_solicitationdaily_opportunity_sweepdescription_text_fetchnotice_by_idopportunities_in_naics_windowopportunity_full_packetsetaside_pipelinesources_sought_in_window
Public safety

FBI Crime Data /servers/fbi-crime-data/mcp

Crime statistics, clearances, and agency-level trends.

agencies_in_stateclearance_rates_by_offensecrime_stats_by_agencycrime_trend_nationalfind_agency_by_namenibrs_offense_lookuptrends_national_summaryviolent_crime_trend_state
Regulatory

Federal Register /servers/federal-register/mcp

Executive orders, proposed rules, and public-inspection lead-time scanning.

agency_metadatadaily_briefing_eo_pulldocuments_by_agencyeo_by_document_numbereo_searchproposed_rule_watchpublic_inspection_lead_time_scannerrecent_eos
Regulatory

Regulations.gov /servers/regulations-gov/mcp

Rulemaking dockets and comment intelligence.

commenters_for_topiccomments_on_documentdocket_by_iddockets_by_agencydocument_by_idrecent_proposed_rulesrecent_rules_by_agencysearch_documents

Errors

What you seeWhat it meansWhat to do
401Missing, malformed, revoked, expired, or unknown key.Check the header spelling, then issue a fresh key from the dashboard.
400 · Missing session IDA request arrived without the MCP session handshake.Call initialize, keep the Mcp-Session-Id header, send notifications/initialized, then retry.
Tool error · quotaThe rolling 24 hour or hourly cap for the plan is reached.Wait for the window to roll, spread calls across keys, or move up a plan.
Tool error · upstreamThe government source refused, timed out, or rate limited the call.Retry with backoff. Repeated failures are reported on status.

Machine readable

/api/catalog, the full catalogue as JSON.
/.well-known/mcp/server-card.json, a static server card for directories.
/healthz, liveness plus server and tool counts.

Fair use

These servers proxy public US government APIs within the rate limits each source sets. Responses are cached where the licence allows, quotas are per account, and abusive traffic is throttled. Do not present this service as an official government data source.