LOGOS — Cortex MCP core reference

Static reference · Governance: Logos/Platform/Admin/LOGOS_MANIFEST.md · MCP URL: https://winbusiness.com/logos/cortex/mcp/ · Generated 2026-05-27 18:45 UTC · Manifests · Data model · MySQL schema · MCP core · Registry parity · Phase 1 lock · Matrix

Quick connect — new MCP clients

  1. URL: https://winbusiness.com/logos/cortex/mcp/ (trailing slash required).
  2. Content-Type: application/json on every POST.
  3. Accept: include application/json (LOGOS middleware may prepend if missing).
  4. Auth: Authorization: Bearer <token>
  5. Protocol: MCP Streamable HTTP 2025-06-18
curl -sS -X POST 'https://winbusiness.com/logos/cortex/mcp/' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"0"}}}'

Architecture

Client compatibility

MCP/identity.py_with_mcp_json_accept_compat avoids 406 when Accept omits application/json. Regression: tests/test_mcp_accept_compat.py.

Core files

PathLinesRole
Logos/Platform/MCP/server.py1134FastMCP singleton, instructions, tool logging.
Logos/Platform/MCP/runtime.py42ASGI app builder for uvicorn.
Logos/Cortex/cortex_mcp.pyCompat entry: re-exports mcp + tools; uvicorn __main__.
Logos/MCP/identity.pyBearer / X-Logos-* → ContextVar; Accept compat for JSON mode.
Logos/MCP/invocation_log.pyPer-tool timing SQLite telemetry.
Logos/MCP/resolvers.pyAI/user/project identifier resolvers for MCP tools.
Logos/MCP/annotations.pyTool safety hints (readOnlyHint, idempotentHint, …) and titles.
Logos/MCP/errors.pyTool error handler, platform log persistence, workspace hints.
Logos/MCP/timing.pyPort/transport config and call_tool outcome/timing helpers.
Logos/Cortex/ai_workspace_db.pySQLite workspace: scopes, audit, views, pages, skills, table move/copy.
Logos/Cortex/workspace_projects.pyProject paths + membership (entity model).
Logos/Cortex/working_memory.pyScratchpad API (legacy: platform SQLite; target: per-agent workspace.db).
Logos/Logos/Platform/Admin/LOGOS_MANIFEST.mdRoot governance map — read first.
Logos/Cortex/MANIFEST.mdCortex folder scope and capabilities.
Logos/Admin/Docs/Cortex/MCP_OPERATIONS.mdMCP authoring rules and ingest routing.
Logos/Matrix/lifecycle.pymessages_* backend: post, process, inbox, deliveries.
Logos/Matrix/lifecycle_schema.pyMySQL migration for lifecycle + deliveries.
Logos/Identity/oauth_bp.pyOAuth routes incl. /validate.
Logos/Identity/oauth.pyOAuth core: pairing, tokens, AI user provision.
Logos/Identity/api_tokens.pyPAT resolution for MCP identity.
Logos/World/developer_routes.pyDeveloper thread, MCP errors/metrics pages.
Logos/World/workspace_routes.pyHuman workspace UI.
Logos/tests/test_cortex_mcp_integration.pyIn-process MCP tool smoke tests.
Logos/tests/test_matrix_lifecycle.pyMatrix lifecycle + deliveries.
Logos/tests/test_mcp_accept_compat.pyAccept header rewrite for MCP JSON mode.

Line counts from live file read (2026-05-27 18:45 UTC).

MCP tools (@mcp.tool)

Live tools/list (2026-05-27 18:45 UTC). Registered in source: 132. Advertised: 131.

NameSource module
ai_session_resumePlatform/MCP/tools/asset_tools/analysis.py
api_paginated_to_sqlPlatform/MCP/tools/asset_tools/ingest/api_json.py
artifact_createPlatform/MCP/tools/asset_tools/artifact_write.py
artifact_create_imagePlatform/MCP/tools/asset_tools/artifact_write.py
artifact_deletePlatform/MCP/tools/asset_tools/artifact_lifecycle.py
artifact_delete_manyPlatform/MCP/tools/asset_tools/artifact_lifecycle.py
artifact_download_base64Platform/MCP/tools/asset_tools/artifact_read.py
artifact_exportPlatform/MCP/tools/asset_tools/artifact_write.py
artifact_getPlatform/MCP/tools/asset_tools/artifact_read.py
artifact_import_urlPlatform/MCP/tools/asset_tools/artifact_write.py
artifact_listPlatform/MCP/tools/asset_tools/artifact_lifecycle.py
artifact_movePlatform/MCP/tools/asset_tools/artifact_read.py
artifact_promotePlatform/MCP/tools/asset_tools/artifact_write.py
artifact_read_textPlatform/MCP/tools/asset_tools/artifact_read.py
artifact_restorePlatform/MCP/tools/asset_tools/artifact_lifecycle.py
artifact_restore_manyPlatform/MCP/tools/asset_tools/artifact_lifecycle.py
artifact_updatePlatform/MCP/tools/asset_tools/artifact_write.py
artifact_uploadPlatform/MCP/tools/asset_tools/artifact_write.py
cleanup_manifest_listPlatform/MCP/tools/asset_tools/cleanup.py
cleanup_manifest_recordPlatform/MCP/tools/asset_tools/cleanup.py
client_reflectionPlatform/MCP/tools/workspace_sql_tools/sql_identity.py
cognition_deletePlatform/MCP/tools/entity_tools/entity_write.py
entity_add_relationshipPlatform/MCP/tools/entity_tools/entity_write.py
entity_emulatePlatform/MCP/tools/resource_tools/emulate.py
entity_getPlatform/MCP/tools/entity_tools/entity_read.py
entity_get_bootstrapPlatform/MCP/tools/entity_tools/entity_read.py
entity_listPlatform/MCP/tools/entity_tools/entity_read.py
entity_registerPlatform/MCP/tools/entity_tools/entity_write.py
entity_save_personalityPlatform/MCP/tools/entity_tools/entity_write.py
goal_addPlatform/MCP/tools/entity_tools/entity_write.py
ingest_tool_routingPlatform/MCP/tools/workspace_sql_tools/sql_routing.py
job_approvePlatform/MCP/tools/job_tools.py
job_getPlatform/MCP/tools/job_tools.py
job_listPlatform/MCP/tools/job_tools.py
job_pausePlatform/MCP/tools/job_tools.py
job_resumePlatform/MCP/tools/job_tools.py
job_run_historyPlatform/MCP/tools/job_tools.py
job_run_nowPlatform/MCP/tools/job_tools.py
job_schedulePlatform/MCP/tools/job_tools.py
job_updatePlatform/MCP/tools/job_tools.py
json_artifact_to_sqlPlatform/MCP/tools/asset_tools/ingest/json_sql.py
json_artifacts_batch_to_sqlPlatform/MCP/tools/asset_tools/ingest/json_batch.py
launch_jobsPlatform/MCP/tools/job_tools.py
logos_docs_getPlatform/MCP/tools/resource_tools/docs.py
logos_fetchPlatform/MCP/tools/web_tools.py
mcp_tool_catalogPlatform/MCP/tools/mcp_tool_catalog_tools.py
mcp_tool_getPlatform/MCP/tools/mcp_tool_catalog_tools.py
menu_link_createPlatform/MCP/tools/view_tools.py
menu_link_listPlatform/MCP/tools/view_tools.py
message_rule_createPlatform/MCP/tools/messaging_tools/rules.py
message_rule_deletePlatform/MCP/tools/messaging_tools/rules.py
message_rule_listPlatform/MCP/tools/messaging_tools/rules.py
messages_archivePlatform/MCP/tools/messaging_tools/messages.py
messages_getPlatform/MCP/tools/messaging_tools/messages.py
messages_inbox_checkPlatform/MCP/tools/messaging_tools/messages.py
messages_listPlatform/MCP/tools/messaging_tools/messages.py
messages_mark_readPlatform/MCP/tools/messaging_tools/messages.py
messages_postPlatform/MCP/tools/messaging_tools/messages.py
messages_processPlatform/MCP/tools/messaging_tools/messages.py
messages_replyPlatform/MCP/tools/messaging_tools/messages.py
messages_unarchivePlatform/MCP/tools/messaging_tools/messages.py
page_createPlatform/MCP/tools/view_tools.py
page_getPlatform/MCP/tools/view_tools.py
page_listPlatform/MCP/tools/view_tools.py
pair_to_humanPlatform/MCP/tools/workspace_sql_tools/sql_identity.py
project_add_memberPlatform/MCP/tools/project_tools.py
project_archivePlatform/MCP/tools/project_tools.py
project_createPlatform/MCP/tools/project_tools.py
project_getPlatform/MCP/tools/project_tools.py
project_listPlatform/MCP/tools/project_tools.py
project_remove_memberPlatform/MCP/tools/project_tools.py
project_state_getPlatform/MCP/tools/asset_tools/analysis.py
project_state_updatePlatform/MCP/tools/asset_tools/analysis.py
registry_asset_graphPlatform/MCP/tools/registry_tools.py
registry_find_assetsPlatform/MCP/tools/registry_tools.py
registry_get_eventsPlatform/MCP/tools/registry_tools.py
registry_link_assetsPlatform/MCP/tools/registry_tools.py
registry_log_eventPlatform/MCP/tools/registry_tools.py
registry_register_assetPlatform/MCP/tools/registry_tools.py
registry_set_attributePlatform/MCP/tools/registry_tools.py
registry_skill_compositionPlatform/MCP/tools/registry_tools.py
report_generate_from_tablesPlatform/MCP/tools/asset_tools/analysis.py
report_issuePlatform/MCP/tools/asset_tools/ingest/report.py
report_publishPlatform/MCP/tools/report_tools.py
skill_catalogPlatform/MCP/tools/skill_tools.py
skill_createPlatform/MCP/tools/skill_tools.py
skill_find_by_triggerPlatform/MCP/tools/skill_tools.py
skill_for_tablePlatform/MCP/tools/skill_tools.py
skill_getPlatform/MCP/tools/skill_tools.py
skill_historyPlatform/MCP/tools/skill_tools.py
skill_listPlatform/MCP/tools/skill_tools.py
sql_artifacts_referencing_tablePlatform/MCP/tools/workspace_sql_tools/sql_manage.py
sql_bulk_insert_jsonPlatform/MCP/tools/asset_tools/ingest/bulk_json.py
sql_describe_tablePlatform/MCP/tools/workspace_sql_tools/sql_catalog.py
sql_entity_resolutionPlatform/MCP/tools/asset_tools/analysis.py
sql_executePlatform/MCP/tools/workspace_sql_tools/sql_read_write.py
sql_import_csvPlatform/MCP/tools/asset_tools/ingest/csv.py
sql_inventory_reportPlatform/MCP/tools/asset_tools/analysis.py
sql_list_tablesPlatform/MCP/tools/workspace_sql_tools/sql_catalog.py
sql_profile_tablePlatform/MCP/tools/asset_tools/analysis.py
sql_queryPlatform/MCP/tools/workspace_sql_tools/sql_read_write.py
sql_recent_auditPlatform/MCP/tools/workspace_sql_tools/sql_manage.py
sql_register_tablePlatform/MCP/tools/workspace_sql_tools/sql_manage.py
sql_sample_tablePlatform/MCP/tools/workspace_sql_tools/sql_routing.py
sql_script_executePlatform/MCP/tools/asset_tools/ingest/script.py
sql_search_tablesPlatform/MCP/tools/workspace_sql_tools/sql_catalog.py
sql_table_copyPlatform/MCP/tools/workspace_sql_tools/sql_manage.py
sql_table_movePlatform/MCP/tools/workspace_sql_tools/sql_manage.py
sql_workflow_guidePlatform/MCP/tools/workspace_sql_tools/sql_catalog.py
talk_to_logos_agentPlatform/MCP/tools/agent_exchange_tools.py
talk_to_logos_agent_historyPlatform/MCP/tools/agent_exchange_tools.py
talk_to_logos_agent_pollPlatform/MCP/tools/agent_exchange_tools.py
talk_to_logos_agent_reply_batchPlatform/MCP/tools/agent_exchange_tools.py
task_addPlatform/MCP/tools/entity_tools/entity_write.py
thought_addPlatform/MCP/tools/entity_tools/entity_write.py
thought_category_listPlatform/MCP/tools/entity_tools/entity_read.py
thought_getPlatform/MCP/tools/entity_tools/entity_read.py
thought_historyPlatform/MCP/tools/entity_tools/entity_read.py
thought_listPlatform/MCP/tools/entity_tools/entity_read.py
view_createPlatform/MCP/tools/view_tools.py
view_getPlatform/MCP/tools/view_tools.py
view_listPlatform/MCP/tools/view_tools.py
web_extract_to_artifactPlatform/MCP/tools/asset_tools/analysis.py
whoamiPlatform/MCP/tools/workspace_sql_tools/sql_identity.py
working_memory_clearPlatform/MCP/tools/working_memory_tools.py
working_memory_listPlatform/MCP/tools/working_memory_tools.py
working_memory_readPlatform/MCP/tools/working_memory_tools.py
working_memory_writePlatform/MCP/tools/working_memory_tools.py
workspace_cleanup_executePlatform/MCP/tools/asset_tools/cleanup.py
workspace_package_indexPlatform/MCP/tools/asset_tools/analysis.py
workspace_promote_packagePlatform/MCP/tools/asset_tools/ingest/packages.py

MCP resources

URIDescription
cortex://entities/{name}Entity profile.
cortex://workspace/catalogScopes + visible tables JSON.
cortex://infoCapabilities / quickstarts.
cortex://documentationManifest pack (like logos_docs_get()).

MCP boot

Full instructions= string lives in Platform/MCP/server.py; not duplicated here.