Trillion Docs

When your AI is connected to Trillion, it gets a set of tools. You never call them by name: you ask in plain words, like “Use Trillion to help me decide what to focus on this week”, and your AI picks the tools that do it. These pages list every tool, grouped by the job a person does, with what it does, what it takes, and an example of what your AI sends.

Setup and goals

Start Trillion with a new person and keep what they are working toward.

Decisions

Walk a decision through its questions, record the choice, and learn from how it turned out.

Messages and activity

Keep conversations word for word so every AI you use can read them, and see what your AIs did.

Workshop tools

Find a tool that does the job, run it, build your own and offer it to others.

Workflows

Get a job done in several checked steps, and keep your own step-by-step methods.

Rules, schedules and connected accounts

Make Trillion run a tool or workflow by itself when something happens or at a set time.

Files and media

Save, find, read and show your files, and find moments in your recordings.

Hand off work

Let the AIs you use find each other and hand work on, on your account or inside a shared space.

Shared spaces

Work with other people in a group, project or event: invite them, share into it, and decide who may do what.

Sharing

Choose who sees each thing you keep, where the things you send to Trillion go, and read what others shared with you.

People and introductions

Find people on the Trillion network who offer what you need, and ask to meet them.

Communities

Join a community, post, go to events, take courses and meet other members.

Book a session

See the sessions you can book with a person, pay, pick a time, and move or cancel it.

Writing

Write in your own formats, and keep private answers to the questions your audience asks.

How the tools work

One address, every AI. Every AI app reaches the same tools at https://app.gettrillion.ai/mcp, and every AI signed in to your account reads and writes the same Trillion. What you start in one AI, another can pick up.
Signed in as you. Your AI signs in with your passkey once. It only ever reaches your own Trillion and the spaces you are in.
Reads only, or changes things. Each tool is marked so your AI app knows which ones only read and which change something. Apps that ask before a tool runs use this to decide what to ask about.
Safe to send twice. Tools that start something take a request_key or source_id: sending the same one again returns what was already started instead of doing it twice.
Some tools come with a paid plan. The free plan includes 5 decisions a month and keeps none of them. A paid plan keeps every decision, note and result, and adds the Workshop, files, shared spaces, the network, handing work between your AIs, and fast picks with score_candidates. Communities and connecting any AI app come with every account.

Every tool

Tool	What it does	Page	Effect
`start_setup`	Start Trillion setup	Setup and goals	Reads only
`list_pursuits`	List what I am pursuing	Setup and goals	Reads only
`record_pursuits`	Record what I am pursuing	Setup and goals	Changes things
`list_methods`	List decision methods	Decisions	Reads only
`start_decision`	Start a decision	Decisions	Changes things
`next_question`	Get the next question	Decisions	Reads only
`answer_question`	Answer a question	Decisions	Changes things
`revise_evidence`	Revise the evidence	Decisions	Changes things
`add_note`	Add a note	Decisions	Changes things
`decide`	Record the decision	Decisions	Changes things
`report_result`	Report how it went	Decisions	Changes things
`list_decisions`	List my decisions	Decisions	Reads only
`export_decision`	Export a decision	Decisions	Reads only
`related_decisions`	Find similar decisions	Decisions	Reads only
`read_shared_decision`	Read the shared decision behind a question	Decisions	Reads only
`what_helped`	What has helped	Decisions	Reads only
`score_candidates`	Score known answers	Decisions	Reads only
`record_messages`	Record messages	Messages and activity	Changes things
`read_messages`	Read messages from all AIs	Messages and activity	Reads only
`bring_in_chat`	Bring in one chat	Messages and activity	Changes things
`bring_in_chat_export`	Bring in a chat export	Messages and activity	Changes things
`read_activity`	Read what my AIs did	Messages and activity	Reads only
`trace_item`	Trace how something came about	Messages and activity	Reads only
`find_tool_for_job`	Find a tool for a job	Workshop tools	Reads only
`run_tool`	Run a tool	Workshop tools	Changes things
`read_task`	Read a tool run	Workshop tools	Reads only
`describe_tool`	Read a tool’s descriptor	Workshop tools	Reads only
`save_tool`	Save a tool	Workshop tools	Changes things
`delete_tool`	Delete a saved tool	Workshop tools	Changes things and can remove them
`publish_tool`	Publish a tool	Workshop tools	Changes things
`unpublish_tool`	Withdraw a published tool	Workshop tools	Changes things and can remove them
`find_workflow`	Find a workflow for a job	Workflows	Reads only
`describe_workflow`	Read a workflow	Workflows	Reads only
`start_workflow`	Start a workflow	Workflows	Changes things
`submit_workflow_step`	Submit a workflow step	Workflows	Changes things
`read_workflow_run`	Read a workflow run	Workflows	Changes things
`save_workflow`	Save a workflow	Workflows	Changes things
`publish_workflow`	Publish a workflow	Workflows	Changes things
`unpublish_workflow`	Withdraw a published workflow	Workflows	Changes things and can remove them
`set_rule`	Set what happens by itself when something happens	Rules, schedules and connected accounts	Changes things
`list_rules`	List my rules	Rules, schedules and connected accounts	Reads only
`remove_rule`	Remove a rule	Rules, schedules and connected accounts	Changes things and can remove them
`set_schedule`	Set something to run at a time	Rules, schedules and connected accounts	Changes things
`list_schedules`	List my schedules	Rules, schedules and connected accounts	Reads only
`run_now`	Run a rule or schedule now	Rules, schedules and connected accounts	Changes things
`remove_schedule`	Remove a schedule	Rules, schedules and connected accounts	Changes things and can remove them
`list_connections`	List my connected accounts	Rules, schedules and connected accounts	Reads only
`connect_service`	Connect one of my accounts	Rules, schedules and connected accounts	Changes things
`listen_for_events`	Start receiving comments and messages	Rules, schedules and connected accounts	Changes things
`list_files`	List a folder of my files	Files and media	Reads only
`find_file`	Find one of my files	Files and media	Reads only
`read_file`	Read one of my files	Files and media	Reads only
`show_file`	Show a file	Files and media	Reads only
`write_file`	Save a file	Files and media	Changes things
`start_file_upload`	Start saving a big file	Files and media	Changes things
`put_file_piece`	Send a piece of a file	Files and media	Changes things
`finish_file_upload`	Finish saving a file	Files and media	Changes things
`cancel_file_upload`	Stop saving a file	Files and media	Changes things and can remove them
`files_summary`	Summarize my stored files	Files and media	Reads only
`read_file_results`	Read what is known about a file	Files and media	Reads only
`list_file_results`	List what is known about my files	Files and media	Reads only
`record_file_results`	Record what was worked out about files	Files and media	Changes things
`list_media`	List my media	Files and media	Reads only
`search_media`	Find moments in my media	Files and media	Reads only
`next_media_edit`	Read my next edit suggestion	Files and media	Reads only
`publish_agent`	Say what this agent does	Hand off work	Changes things
`set_agent_capacity`	Report this agent’s capacity	Hand off work	Changes things
`agent_presence`	Say this agent is present	Hand off work	Changes things
`find_agents`	Find agents for a job	Hand off work	Reads only
`hand_off`	Hand a job to another agent	Hand off work	Changes things
`take_work`	Take waiting work	Hand off work	Changes things
`finish_work`	Finish taken work	Hand off work	Changes things
`read_handoff`	Read a handoff	Hand off work	Reads only
`address_open_work`	Name the agent for waiting work	Hand off work	Changes things
`send_agent_event`	Wake an agent with an event	Hand off work	Changes things
`read_agent_events`	Read the events sent about something	Hand off work	Reads only
`saved_instructions`	Read or change saved instructions	Hand off work	Changes things
`make_agent_key`	Make a key with a chosen reach	Hand off work	Changes things
`publish_space_agent`	Put an agent to work in a space	Hand off work	Changes things
`withdraw_space_agent`	Stop an agent working in a space	Hand off work	Changes things and can remove them
`find_space_agents`	Find agents in a space	Hand off work	Reads only
`hand_off_in_space`	Hand work to an agent in a space	Hand off work	Changes things
`take_space_work`	Take work in a space	Hand off work	Changes things
`finish_space_work`	Finish work in a space	Hand off work	Changes things
`read_space_handoff`	Read a handoff in a space	Hand off work	Reads only
`list_spaces`	List my shared spaces	Shared spaces	Reads only
`open_space`	Open a shared space	Shared spaces	Reads only
`create_membership`	Start a shared space	Shared spaces	Changes things
`read_space`	Read a shared space	Shared spaces	Reads only
`add_to_space`	Add to a shared space	Shared spaces	Changes things
`share_to_space`	Share one record into a space	Shared spaces	Changes things
`withdraw_from_space`	Withdraw from a space	Shared spaces	Changes things and can remove them
`read_shared_file`	Read a shared file	Shared spaces	Reads only
`mark_space_seen`	Mark a space seen	Shared spaces	Changes things
`describe_space`	Describe a space and set its picture	Shared spaces	Changes things
`read_space_picture`	Read a space’s picture	Shared spaces	Reads only
`name_in_space`	Set my name in a space	Shared spaces	Changes things
`make_space_invite`	Make an invite link to a space	Shared spaces	Changes things
`list_space_invites`	List my invite links to a space	Shared spaces	Reads only
`revoke_space_invite`	Revoke an invite link	Shared spaces	Changes things and can remove them
`join_space`	Join a space with an invite link	Shared spaces	Changes things
`leave_membership`	Leave a group, event or introduction	Shared spaces	Changes things and can remove them
`read_space_rules`	Read who may do what in a space	Shared spaces	Reads only
`set_space_rules`	Change who may do what in a space	Shared spaces	Changes things and can remove them
`set_member_type`	Give a member a type in a space	Shared spaces	Changes things
`add_member_type`	Add a member type to a space	Shared spaces	Changes things
`remove_member_type`	Remove a member type from a space	Shared spaces	Changes things and can remove them
`hide_in_space`	Hide or show a thing in a space	Shared spaces	Changes things
`sharing_of`	See who a record is shared with	Sharing	Reads only
`set_sharing`	Choose who a record is shared with	Sharing	Changes things
`shared_with_me`	See what people shared with me	Sharing	Reads only
`read_shared`	Read something shared with me	Sharing	Reads only
`share_destinations`	Read where my shares go	Sharing	Reads only
`save_share_destinations`	Change where my shares go	Sharing	Changes things
`network_profile`	Set how people can find me	People and introductions	Changes things
`find_people`	Find people	People and introductions	Reads only
`request_introduction`	Ask to meet someone	People and introductions	Changes things
`network`	My network	People and introductions	Reads only
`answer_introduction`	Answer a request to meet	People and introductions	Changes things
`label_person`	Label a person	People and introductions	Changes things
`list_communities`	Communities	Communities	Reads only
`community`	Open a community	Communities	Reads only
`join_community`	Join a community	Communities	Changes things
`whats_new`	What is new in a community	Communities	Changes things
`post_to_community`	Post in a community	Communities	Changes things
`vote_post`	Vote for a post	Communities	Changes things
`remove_post`	Remove a post	Communities	Changes things and can remove them
`rsvp_event`	Answer an event	Communities	Changes things
`create_community_event`	Put on an event	Communities	Changes things
`complete_lesson`	Mark a lesson done	Communities	Changes things
`claim_reward`	Claim a reward	Communities	Changes things
`community_notifications`	Community email digest	Communities	Changes things
`my_matches`	My matches in a community	Communities	Reads only
`set_matching`	Pair me automatically	Communities	Changes things
`score_match_candidates`	Score who to meet	Communities	Changes things
`suggest_match_topics`	Suggest what to talk about	Communities	Changes things
`pass_match`	Pass on a match	Communities	Changes things
`change_community`	Change a community	Communities	Changes things
`set_member_role`	Give a member a role	Communities	Changes things
`send_community_digests`	Send community digests now	Communities	Changes things
`run_matching_round`	Start a pairing round	Communities	Changes things
`hand_over_community`	Hand a community over	Communities	Changes things
`session_offers`	Sessions I can book with a person	Book a session	Changes things
`open_session_times`	Open times for a session	Book a session	Reads only
`buy_session`	Pick a time and get the checkout for a session	Book a session	Changes things
`book_session_time`	Book a session time	Book a session	Changes things
`change_session`	Move or cancel a session	Book a session	Changes things and can remove them
`content_formats`	Read my content formats	Writing	Reads only
`save_content_formats`	Save my content formats	Writing	Changes things
`list_audience_questions`	Read audience questions	Writing	Reads only
`observe_audience_source`	Check a public source	Writing	Changes things
`keep_audience_question`	Keep an audience question	Writing	Changes things
`review_audience_question`	Review an audience question	Writing	Changes things
`admit_audience_question`	Add to private drafts	Writing	Changes things
`save_audience_answer_draft`	Save a private answer draft	Writing	Changes things

Tool reference

Tools reference

Setup and goals

Decisions

Messages and activity

Workshop tools

Workflows

Rules, schedules and connected accounts

Files and media

Hand off work

Shared spaces

Sharing

People and introductions

Communities

Book a session

Writing

How the tools work

Every tool

Setup and goals

Decisions

Messages and activity

Workshop tools

Workflows

Rules, schedules and connected accounts

Files and media

Hand off work

Shared spaces

Sharing

People and introductions

Communities

Book a session

Writing

​How the tools work

​Every tool

How the tools work

Every tool