LOGOS — Cortex MCP core reference

Quick connect — new MCP clients

URL: https://winbusiness.com/logos/cortex/mcp/ (trailing slash required).
Content-Type: application/json on every POST.
Accept: include application/json (LOGOS middleware may prepend if missing).
Auth: Authorization: Bearer <token>
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

Transport: Streamable HTTP, json_response=True, port 8001 (cortex-mcp).
Auth: nginx auth_request → /logos/oauth/validate; X-Logos-* headers.
Data: MySQL (Cortex entities, thoughts) + SQLite Logos/World/Workspaces/ (Global / Users / Projects / Agents target).
Messaging: public MCP messages_*, message_rule_*; Matrix is internal implementation.
Doctrine: Logos/Platform/Admin/LOGOS_ARCHITECTURE.md — platform vs in-platform work (see manifests snapshot).
Tools: 132 registered · 131 advertised via tools/list.

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

Path	Lines	Role
`Logos/Platform/MCP/server.py`	1134	FastMCP singleton, instructions, tool logging.
`Logos/Platform/MCP/runtime.py`	42	ASGI app builder for uvicorn.
`Logos/Cortex/cortex_mcp.py`	—	Compat entry: re-exports mcp + tools; uvicorn __main__.
`Logos/MCP/identity.py`	—	Bearer / X-Logos-* → ContextVar; Accept compat for JSON mode.
`Logos/MCP/invocation_log.py`	—	Per-tool timing SQLite telemetry.
`Logos/MCP/resolvers.py`	—	AI/user/project identifier resolvers for MCP tools.
`Logos/MCP/annotations.py`	—	Tool safety hints (readOnlyHint, idempotentHint, …) and titles.
`Logos/MCP/errors.py`	—	Tool error handler, platform log persistence, workspace hints.
`Logos/MCP/timing.py`	—	Port/transport config and call_tool outcome/timing helpers.
`Logos/Cortex/ai_workspace_db.py`	—	SQLite workspace: scopes, audit, views, pages, skills, table move/copy.
`Logos/Cortex/workspace_projects.py`	—	Project paths + membership (entity model).
`Logos/Cortex/working_memory.py`	—	Scratchpad API (legacy: platform SQLite; target: per-agent workspace.db).
`Logos/Logos/Platform/Admin/LOGOS_MANIFEST.md`	—	Root governance map — read first.
`Logos/Cortex/MANIFEST.md`	—	Cortex folder scope and capabilities.
`Logos/Admin/Docs/Cortex/MCP_OPERATIONS.md`	—	MCP authoring rules and ingest routing.
`Logos/Matrix/lifecycle.py`	—	messages_* backend: post, process, inbox, deliveries.
`Logos/Matrix/lifecycle_schema.py`	—	MySQL migration for lifecycle + deliveries.
`Logos/Identity/oauth_bp.py`	—	OAuth routes incl. /validate.
`Logos/Identity/oauth.py`	—	OAuth core: pairing, tokens, AI user provision.
`Logos/Identity/api_tokens.py`	—	PAT resolution for MCP identity.
`Logos/World/developer_routes.py`	—	Developer thread, MCP errors/metrics pages.
`Logos/World/workspace_routes.py`	—	Human workspace UI.
`Logos/tests/test_cortex_mcp_integration.py`	—	In-process MCP tool smoke tests.
`Logos/tests/test_matrix_lifecycle.py`	—	Matrix lifecycle + deliveries.
`Logos/tests/test_mcp_accept_compat.py`	—	Accept 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.

Name	Source module
`ai_session_resume`	`Platform/MCP/tools/asset_tools/analysis.py`
`api_paginated_to_sql`	`Platform/MCP/tools/asset_tools/ingest/api_json.py`
`artifact_create`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_create_image`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_delete`	`Platform/MCP/tools/asset_tools/artifact_lifecycle.py`
`artifact_delete_many`	`Platform/MCP/tools/asset_tools/artifact_lifecycle.py`
`artifact_download_base64`	`Platform/MCP/tools/asset_tools/artifact_read.py`
`artifact_export`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_get`	`Platform/MCP/tools/asset_tools/artifact_read.py`
`artifact_import_url`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_list`	`Platform/MCP/tools/asset_tools/artifact_lifecycle.py`
`artifact_move`	`Platform/MCP/tools/asset_tools/artifact_read.py`
`artifact_promote`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_read_text`	`Platform/MCP/tools/asset_tools/artifact_read.py`
`artifact_restore`	`Platform/MCP/tools/asset_tools/artifact_lifecycle.py`
`artifact_restore_many`	`Platform/MCP/tools/asset_tools/artifact_lifecycle.py`
`artifact_update`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`artifact_upload`	`Platform/MCP/tools/asset_tools/artifact_write.py`
`cleanup_manifest_list`	`Platform/MCP/tools/asset_tools/cleanup.py`
`cleanup_manifest_record`	`Platform/MCP/tools/asset_tools/cleanup.py`
`client_reflection`	`Platform/MCP/tools/workspace_sql_tools/sql_identity.py`
`cognition_delete`	`Platform/MCP/tools/entity_tools/entity_write.py`
`entity_add_relationship`	`Platform/MCP/tools/entity_tools/entity_write.py`
`entity_emulate`	`Platform/MCP/tools/resource_tools/emulate.py`
`entity_get`	`Platform/MCP/tools/entity_tools/entity_read.py`
`entity_get_bootstrap`	`Platform/MCP/tools/entity_tools/entity_read.py`
`entity_list`	`Platform/MCP/tools/entity_tools/entity_read.py`
`entity_register`	`Platform/MCP/tools/entity_tools/entity_write.py`
`entity_save_personality`	`Platform/MCP/tools/entity_tools/entity_write.py`
`goal_add`	`Platform/MCP/tools/entity_tools/entity_write.py`
`ingest_tool_routing`	`Platform/MCP/tools/workspace_sql_tools/sql_routing.py`
`job_approve`	`Platform/MCP/tools/job_tools.py`
`job_get`	`Platform/MCP/tools/job_tools.py`
`job_list`	`Platform/MCP/tools/job_tools.py`
`job_pause`	`Platform/MCP/tools/job_tools.py`
`job_resume`	`Platform/MCP/tools/job_tools.py`
`job_run_history`	`Platform/MCP/tools/job_tools.py`
`job_run_now`	`Platform/MCP/tools/job_tools.py`
`job_schedule`	`Platform/MCP/tools/job_tools.py`
`job_update`	`Platform/MCP/tools/job_tools.py`
`json_artifact_to_sql`	`Platform/MCP/tools/asset_tools/ingest/json_sql.py`
`json_artifacts_batch_to_sql`	`Platform/MCP/tools/asset_tools/ingest/json_batch.py`
`launch_jobs`	`Platform/MCP/tools/job_tools.py`
`logos_docs_get`	`Platform/MCP/tools/resource_tools/docs.py`
`logos_fetch`	`Platform/MCP/tools/web_tools.py`
`mcp_tool_catalog`	`Platform/MCP/tools/mcp_tool_catalog_tools.py`
`mcp_tool_get`	`Platform/MCP/tools/mcp_tool_catalog_tools.py`
`menu_link_create`	`Platform/MCP/tools/view_tools.py`
`menu_link_list`	`Platform/MCP/tools/view_tools.py`
`message_rule_create`	`Platform/MCP/tools/messaging_tools/rules.py`
`message_rule_delete`	`Platform/MCP/tools/messaging_tools/rules.py`
`message_rule_list`	`Platform/MCP/tools/messaging_tools/rules.py`
`messages_archive`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_get`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_inbox_check`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_list`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_mark_read`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_post`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_process`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_reply`	`Platform/MCP/tools/messaging_tools/messages.py`
`messages_unarchive`	`Platform/MCP/tools/messaging_tools/messages.py`
`page_create`	`Platform/MCP/tools/view_tools.py`
`page_get`	`Platform/MCP/tools/view_tools.py`
`page_list`	`Platform/MCP/tools/view_tools.py`
`pair_to_human`	`Platform/MCP/tools/workspace_sql_tools/sql_identity.py`
`project_add_member`	`Platform/MCP/tools/project_tools.py`
`project_archive`	`Platform/MCP/tools/project_tools.py`
`project_create`	`Platform/MCP/tools/project_tools.py`
`project_get`	`Platform/MCP/tools/project_tools.py`
`project_list`	`Platform/MCP/tools/project_tools.py`
`project_remove_member`	`Platform/MCP/tools/project_tools.py`
`project_state_get`	`Platform/MCP/tools/asset_tools/analysis.py`
`project_state_update`	`Platform/MCP/tools/asset_tools/analysis.py`
`registry_asset_graph`	`Platform/MCP/tools/registry_tools.py`
`registry_find_assets`	`Platform/MCP/tools/registry_tools.py`
`registry_get_events`	`Platform/MCP/tools/registry_tools.py`
`registry_link_assets`	`Platform/MCP/tools/registry_tools.py`
`registry_log_event`	`Platform/MCP/tools/registry_tools.py`
`registry_register_asset`	`Platform/MCP/tools/registry_tools.py`
`registry_set_attribute`	`Platform/MCP/tools/registry_tools.py`
`registry_skill_composition`	`Platform/MCP/tools/registry_tools.py`
`report_generate_from_tables`	`Platform/MCP/tools/asset_tools/analysis.py`
`report_issue`	`Platform/MCP/tools/asset_tools/ingest/report.py`
`report_publish`	`Platform/MCP/tools/report_tools.py`
`skill_catalog`	`Platform/MCP/tools/skill_tools.py`
`skill_create`	`Platform/MCP/tools/skill_tools.py`
`skill_find_by_trigger`	`Platform/MCP/tools/skill_tools.py`
`skill_for_table`	`Platform/MCP/tools/skill_tools.py`
`skill_get`	`Platform/MCP/tools/skill_tools.py`
`skill_history`	`Platform/MCP/tools/skill_tools.py`
`skill_list`	`Platform/MCP/tools/skill_tools.py`
`sql_artifacts_referencing_table`	`Platform/MCP/tools/workspace_sql_tools/sql_manage.py`
`sql_bulk_insert_json`	`Platform/MCP/tools/asset_tools/ingest/bulk_json.py`
`sql_describe_table`	`Platform/MCP/tools/workspace_sql_tools/sql_catalog.py`
`sql_entity_resolution`	`Platform/MCP/tools/asset_tools/analysis.py`
`sql_execute`	`Platform/MCP/tools/workspace_sql_tools/sql_read_write.py`
`sql_import_csv`	`Platform/MCP/tools/asset_tools/ingest/csv.py`
`sql_inventory_report`	`Platform/MCP/tools/asset_tools/analysis.py`
`sql_list_tables`	`Platform/MCP/tools/workspace_sql_tools/sql_catalog.py`
`sql_profile_table`	`Platform/MCP/tools/asset_tools/analysis.py`
`sql_query`	`Platform/MCP/tools/workspace_sql_tools/sql_read_write.py`
`sql_recent_audit`	`Platform/MCP/tools/workspace_sql_tools/sql_manage.py`
`sql_register_table`	`Platform/MCP/tools/workspace_sql_tools/sql_manage.py`
`sql_sample_table`	`Platform/MCP/tools/workspace_sql_tools/sql_routing.py`
`sql_script_execute`	`Platform/MCP/tools/asset_tools/ingest/script.py`
`sql_search_tables`	`Platform/MCP/tools/workspace_sql_tools/sql_catalog.py`
`sql_table_copy`	`Platform/MCP/tools/workspace_sql_tools/sql_manage.py`
`sql_table_move`	`Platform/MCP/tools/workspace_sql_tools/sql_manage.py`
`sql_workflow_guide`	`Platform/MCP/tools/workspace_sql_tools/sql_catalog.py`
`talk_to_logos_agent`	`Platform/MCP/tools/agent_exchange_tools.py`
`talk_to_logos_agent_history`	`Platform/MCP/tools/agent_exchange_tools.py`
`talk_to_logos_agent_poll`	`Platform/MCP/tools/agent_exchange_tools.py`
`talk_to_logos_agent_reply_batch`	`Platform/MCP/tools/agent_exchange_tools.py`
`task_add`	`Platform/MCP/tools/entity_tools/entity_write.py`
`thought_add`	`Platform/MCP/tools/entity_tools/entity_write.py`
`thought_category_list`	`Platform/MCP/tools/entity_tools/entity_read.py`
`thought_get`	`Platform/MCP/tools/entity_tools/entity_read.py`
`thought_history`	`Platform/MCP/tools/entity_tools/entity_read.py`
`thought_list`	`Platform/MCP/tools/entity_tools/entity_read.py`
`view_create`	`Platform/MCP/tools/view_tools.py`
`view_get`	`Platform/MCP/tools/view_tools.py`
`view_list`	`Platform/MCP/tools/view_tools.py`
`web_extract_to_artifact`	`Platform/MCP/tools/asset_tools/analysis.py`
`whoami`	`Platform/MCP/tools/workspace_sql_tools/sql_identity.py`
`working_memory_clear`	`Platform/MCP/tools/working_memory_tools.py`
`working_memory_list`	`Platform/MCP/tools/working_memory_tools.py`
`working_memory_read`	`Platform/MCP/tools/working_memory_tools.py`
`working_memory_write`	`Platform/MCP/tools/working_memory_tools.py`
`workspace_cleanup_execute`	`Platform/MCP/tools/asset_tools/cleanup.py`
`workspace_package_index`	`Platform/MCP/tools/asset_tools/analysis.py`
`workspace_promote_package`	`Platform/MCP/tools/asset_tools/ingest/packages.py`

MCP resources

URI	Description
`cortex://entities/{name}`	Entity profile.
`cortex://workspace/catalog`	Scopes + visible tables JSON.
`cortex://info`	Capabilities / quickstarts.
`cortex://documentation`	Manifest pack (like `logos_docs_get()`).

MCP boot

ensure_lifecycle_schema() — Matrix lifecycle + deliveries.
working_memory.ensure_schema() — scratchpad (legacy platform SQLite).

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

Served at /logos/admin/Reports/ · Developer dashboard: /logos/reports/developer/
Regenerate: python3 Logos/Platform/Admin/Reports/generate_mcp_core_report.py or regenerate_code_displays.py.