Skip to Content
CognitoLabs.AIDocs

Your data (Data Sources)

The team's own data from a conversation - providers and health systems, rate tables and CDMs, volume and cost datasets, payers, fee-schedule import audits, contracts and files, one tool per component.

Data Sources in the app holds what your team brought: the hospitals and health systems you work for, their rate tables and chargemasters (CDMs), volume and cost data, the payer list your data maps onto, contracts and files. Through the MCP server your assistant reads and edits the same records, and anything it saves shows up in the app.

Say something like:

Which rate table does Riverside use, and which payer names in our data aren't mapped yet?

Your assistant calls data_sections() first: it lists every component below with its tool, your team's counts, and a next_step naming what the team lacks (an owner, a fee schedule, a chargemaster, unmapped payers).

Getting data in

  • An owner. Every table belongs to a provider or a health system. data_add_provider bookmarks a CMS hospital by CCN (find it with find_medicare_hospitals) or creates a custom provider; data_create_health_system and data_update_provider(health_system_id=...) group providers. A provider with no rate table of its own uses its health system's.
  • A rate table or CDM. create_upload gives a 15-minute upload link (the file never passes through the conversation), inspect_upload shows the columns, and save_rate_table / save_cdm_table save a new version, which becomes the Latest.
  • Volume or cost data. The same upload, then data_add_dataset with the column mapping and a description. The raw file is deleted once it is read.

Every component

ComponentTool
Owner rail: health systems and providers treedata_providers
Owner rail: Add provider (CMS hospital search)find_medicare_hospitals
Owner rail: Add providerdata_add_provider
Owner rail: Rename / Edit MSA / Move todata_update_provider
Owner rail: Remove providerdata_remove_provider
Owner rail: New health systemdata_create_health_system
Owner rail: Rename / Edit MSA (health system)data_update_health_system
Owner rail: Delete health systemdata_delete_health_system
Provider page: IPPS reference card + linked datadata_provider
Provider page: Medicare calculatorcalculate_medicare_rates
Hospital page: public hospital pageget_hospital
CDM / Rates: versions table (CDM and Rates tabs)data_tables
CDM / Rates: a table's version historydata_table_versions
CDM / Rates: owner resolution (which table a provider uses)data_effective_table
CDM: Set as Latestdata_set_latest
CDM / Rates: Download CSVdata_export_table
CDM / Rates: Upload CDM / Add rate table versioncreate_upload
Rates: rate table row viewerdata_rate_rows
CDM: CDM row viewerdata_cdm_rows
Rates: fee-schedule imports: Draft imports stripdata_fee_imports
Rates: fee-schedule imports: import page (files + status)data_fee_import
Rates: fee-schedule imports: Cross-check stepdata_fee_import_crosscheck
Rates: fee-schedule imports: Commit step + Audit sectiondata_fee_import_audit
Rates: fee-schedule imports: Opportunity carddata_fee_import_uplift
Rates: fee-schedule imports: Timelinedata_fee_import_events
Rates: fee-schedule imports: Binders on record: downloaddata_fee_import_binder
Volume / Costs: datasets tabledata_datasets
Volume / Costs: dataset page summarydata_dataset
Volume / Costs: dataset row viewerdata_dataset_rows
Volume / Costs: New datasetdata_add_dataset
Volume / Costs: Edit description / ownerdata_update_dataset
Volume / Costs: Delete datasetdata_delete_dataset
Volume / Costs: Template downloaddata_dataset_template
Contracts: contracts tabledata_contracts
Contracts: contract page (rates)data_contract
Files: file spaces listdata_file_spaces
Files: a file's textdata_file_space_file
Payers: canonical payersdata_payers
Payers: Unmapped inboxdata_unmapped_payers
Payers: Map to payer (master list search)data_master_payers
Payers: Map to payerdata_map_payer
Payers: Auto-mapdata_auto_map_payers
Payers: New payerdata_create_payer
Payers: Rename / aliases / master linkdata_update_payer
Payers: Merge into...data_merge_payers
Payers: Delete payerdata_delete_payer
Payers: Suggest a payerdata_suggest_master_payer
Connectors: connections list + charge masterdata_connectors
Monitors: monitor cardsdata_monitors

Lists return at most 50 rows a call (limit, offset, total, truncated). Downloads (data_export_table, data_dataset_template, data_fee_import_binder) are short links that work for one hour.

Changes that need your yes

data_set_latest, data_remove_provider, data_delete_health_system, data_delete_dataset, data_merge_payers and data_delete_payer change nothing unless called with confirm=true. Without it they answer what they would do, and your assistant asks you first.

What stays in the app

  • A rate table's Latest. Switching it also re-links the underpayment contracts, which runs with your app sign-in. data_set_latest switches a CDM's Latest; switch a rate table's in the app.
  • Deleting a rate-table or CDM version. The app checks that no study uses the version before it deletes; that check runs with your app sign-in, which an assistant does not carry. Delete versions in the app.
  • Running a fee-schedule import. Reviewing, attesting, committing and approving an import record a named person's sign-off in the audit trail, so an assistant only reads imports: their files, the cross-check, the audit summary, the timeline and the binders on record.
  • Uploading contracts and files into File Spaces, and creating connectors or monitors. The assistant lists them and reads a file's text; connectors are demo integrations and hold no credentials.

Plans

Everything here is your own data and free on every plan, like the app. These calls count against the study-setup allowance (200 a day), not the 10-a-day free data allowance.

On this page