Built-in Tools Reference
Complete reference of all MCP tools exposed by built-in modules. These tools are always available to every agent.
Awareness
Port 7801update_awarenessagent_id, new_awarenessReplace the agent’s awareness profile with an updated Markdown document covering preferences, communication style, and role identity.
update_agent_nameagent_id, new_nameUpdate the agent’s display name.
Social Network
Port 7802extract_entity_infoagent_id, entity_id, updates, update_modeUpdate entity identity, contact info, tags, or keywords. Called when a person introduces themselves or shares structured information.
search_social_networkagent_id, querySemantic search across the social graph by expertise, domain, role, or any combination.
get_contact_infoagent_id, entity_idQuick contact lookup. Returns all registered channels and preferred contact method.
get_agent_social_statsagent_idRelationship summary: recent interactions, strongest ties, tag-filtered entity lists.
contact_agentagent_id, entity_id, messageSend a message to an entity through their best available channel.
check_channel_updatesagent_idCheck for unread messages across all registered communication channels.
merge_entitiesagent_id, primary_id, duplicate_idsConsolidate duplicate entity records into a single primary entity.
delete_entityagent_id, entity_idPermanently delete an entity from the social graph.
create_agentagent_id, name, awarenessCreate a new agent with initial awareness profile.
Jobs
Port 7803job_createagent_id, user_id, title, description, job_type, trigger_config, ...Create a new background job. Supports ONE_OFF, SCHEDULED, RECURRING, and ONGOING types.
job_retrieval_semanticagent_id, querySearch for jobs by semantic similarity to a natural language query.
job_retrieval_by_idagent_id, job_idFetch a specific job by its unique identifier.
job_retrieval_by_keywordsagent_id, keywordsSearch for jobs matching specific keywords.
job_updateagent_id, job_id, updatesUpdate job properties (title, description, trigger config, status).
job_pauseagent_id, job_idPause an active job. Can be resumed later.
job_cancelagent_id, job_idCancel a job permanently.
Chat
Port 7804send_message_to_user_directlyagent_id, user_id, contentThe only way to deliver visible messages to the user. All other agent output remains internal thinking.
get_chat_historyinstance_id, limitRetrieve past conversations for a specific Chat Instance (per-user, per-Narrative history).
Memory / RAG
Port 7805rag_queryagent_id, query, top_kSemantic search across uploaded documents. Returns relevant chunks with source information.
rag_upload_fileagent_id, file_pathUpload a file (PDF, TXT, MD) to the agent’s knowledge base.
rag_upload_textagent_id, title, textUpload text content directly as a named document.
Skills
Port 7806skill_save_configagent_id, user_id, skill_name, env_key, env_valueSave a credential or environment variable for a skill. Required for the skill to function at runtime.
skill_list_required_envagent_id, user_id, skill_nameQuery required environment variables and their current configuration status.
skill_save_study_summaryagent_id, user_id, skill_name, summarySave a structured study summary after the agent has learned a skill.
Agent Communication
Port 7820bus_send_messageagent_id, channel_id, content, mentionsSend a text message to a channel with optional @mentions.
bus_send_to_agentagent_id, target_agent_id, contentDirect message to another agent. Auto-creates a DM channel if needed.
bus_create_channelagent_id, name, member_idsCreate a new group channel with specified members.
bus_get_messagesagent_id, channel_id, limitRetrieve message history from a channel.
bus_get_unreadagent_idFetch unread messages across all subscribed channels.
bus_search_agentsagent_id, queryDiscover agents by capability or description.
bus_register_agentagent_id, capabilities, descriptionRegister agent with capabilities for discovery by other agents.
bus_get_channel_membersagent_id, channel_idList all members of a channel.
bus_leave_channelagent_id, channel_idLeave a channel.
bus_kick_memberagent_id, channel_id, member_idRemove a member from a channel.
bus_get_agent_profileagent_id, target_agent_idGet another agent’s profile and capabilities.