Tools reference
Every tool the FounderSync MCP server offers, grouped by area, with what it does and whether it reads, writes or deletes.
On this page
This page lists all 123 tools on the full endpoint, https://mcp.foundersync.io/mcp. Of these, 53 are read tools, 55 are write tools and 15 are destructive. The read-only endpoint, https://mcp.foundersync.io/mcp/readonly, offers only the 53 read tools. Tool names are exact: your agent calls them as written.
How tools take arguments#
startup_id. Most tools work on one startup and accept an optional startup_id (a UUID). Leave it out when you belong to one startup or have one active. If you belong to several and none is active, the tool asks which one and lists your options; list_startups returns the ids. A startup_id for a startup you are not an active member of is refused.
Tools with no startup_id are personal or global: whoami, list_startups, create_startup, the notification, settings and profile tools, get_prd_format, captable_dilution_calculator and list_integration_connections.
Access. Each tool is one of three kinds:
- read changes nothing.
- write creates or changes data. The change is visible to your cofounders.
- destructive deletes data or records something that cannot be undone. It requires
confirm: true, and the call fails without it. Destructive descriptions say so, and clients that show tool hints mark them as destructive.
Workspace, team and inbox#
| Tool | What it does | Access |
|---|---|---|
whoami | Returns you, your profile, your startups and the active one. | read |
list_startups | Lists your startups with stage, role and team size. | read |
create_startup | Creates a startup and makes you its founder. | write |
switch_active_startup | Sets the active startup used when startup_id is omitted. | write |
get_startup_overview | Summarizes idea, tasks, team, agreement and more in one call. | read |
list_activity | Lists the startup's activity feed, newest first. | read |
list_agent_actions | Lists changes made through AI agents, with client and inputs. | read |
search_workspace | Searches tasks, vault documents, stakeholders and idea fields. | read |
list_team | Lists team members with role, equity, hours and permissions. | read |
update_team_member | Updates a member's title, hours, role, equity or permissions. | write |
list_invitations | Lists cofounder invitations and their status. | read |
invite_cofounder | Invites someone by email and returns the invite link. | write |
cancel_invitation | Cancels a pending invitation. | write |
remove_team_member | Removes a person from the team. | destructive |
list_notifications | Lists your notifications and the unread count. | read |
mark_notifications_read | Marks chosen or all notifications as read. | write |
dismiss_notification | Dismisses one notification. | write |
get_settings | Returns your app settings. | read |
update_settings | Changes your app settings. | write |
get_profile | Returns your profile. | read |
update_profile | Updates your profile; email and account id cannot change. | write |
Idea#
| Tool | What it does | Access |
|---|---|---|
get_idea | Returns the startup idea as the Idea page shows it. | read |
get_idea_completeness | Scores the idea and suggests what to ask next. | read |
update_idea | Updates the idea; only the fields you pass change. | write |
save_idea_artifact | Saves a one-pager, lean canvas or similar next to the idea. | write |
get_idea_artifacts | Returns the saved idea documents. | read |
PRD and roadmap#
| Tool | What it does | Access |
|---|---|---|
get_prd_format | Returns the PRD shape, an example and the allowed values. | read |
get_prd | Returns the PRD with a summary by priority and hours. | read |
save_prd | Creates or replaces the whole PRD. | write |
update_prd_feature | Changes one feature in the existing PRD. | write |
delete_prd | Deletes the PRD; the derived roadmap disappears too. | destructive |
get_roadmap | Derives the roadmap sprints from the PRD. | read |
update_roadmap | Replaces the PRD's milestones, which the roadmap is built from. | write |
Launch#
| Tool | What it does | Access |
|---|---|---|
launch_list_categories | Shows the launch categories with done counts. | read |
launch_get_progress | Lists checklist items with status, with filters. | read |
launch_get_item | Returns one item with guidance, links and notes. | read |
launch_get_next_steps | Returns the highest-value unfinished items. | read |
launch_set_item_status | Sets status or notes on one item. | write |
launch_bulk_set_status | Updates up to 100 items at once. | write |
launch_add_custom_item | Adds your own item to a category. | write |
launch_remove_custom_item | Deletes a custom item with its status and notes. | destructive |
launch_reset_category | Clears a category's statuses and custom items. | destructive |
Tasks#
| Tool | What it does | Access |
|---|---|---|
list_tasks | Lists tasks with filters. | read |
get_task | Returns one task with checklist, comments and activity. | read |
create_task | Creates one task. | write |
create_tasks | Creates up to 50 tasks at once, all or nothing. | write |
update_task | Changes fields of one task. | write |
update_tasks | Applies one change to up to 100 tasks. | write |
complete_task | Marks a task completed, with optional hours and note. | write |
delete_task | Permanently deletes a task with its comments and time. | destructive |
add_task_comment | Adds a comment, or a reply, as you. | write |
list_task_comments | Lists a task's comments. | read |
list_task_categories | Lists task categories you can file under. | read |
log_task_time | Records time you spent on a task. | write |
get_task_stats | Summarizes the board by status, priority, domain and owner. | read |
list_task_templates | Lists reusable task templates. | read |
create_tasks_from_template | Creates tasks from a template. | write |
Contributions and integrations#
| Tool | What it does | Access |
|---|---|---|
list_contributions | Lists who did what, with hours and impact. | read |
log_contribution | Logs work you did; it cannot log for a cofounder. | write |
update_contribution | Edits one of your own manual contributions. | write |
delete_contribution | Permanently deletes one of your manual contributions. | destructive |
get_fairness_summary | Compares each founder's contributions with their equity. | read |
list_integration_connections | Lists which integrations you connected; never returns tokens. | read |
Vault#
| Tool | What it does | Access |
|---|---|---|
vault_list_documents | Lists vault documents, newest first. | read |
vault_get_document | Returns a document's metadata, versions and activity. | read |
vault_create_text_document | Creates a text or Markdown document, up to 1 MB. | write |
vault_update_document | Changes a document's title, tags, category or notes. | write |
vault_archive_document | Hides a document without deleting it. | write |
vault_restore_document | Brings an archived document back. | write |
vault_delete_document | Permanently deletes a document, its files and versions. | destructive |
vault_get_download_url | Returns a private download link valid for 10 minutes. | read |
vault_read_text_document | Returns the text of a text, Markdown, CSV or JSON document. | read |
Cofounder agreement#
| Tool | What it does | Access |
|---|---|---|
get_agreement | Returns all agreement sections, status and who has signed. | read |
update_agreement_section | Updates one section; only the parts you send change. | write |
mark_agreement_module_configured | Sets a module to configured, in progress or not started. | write |
list_agreement_reviews | Lists prompts to re-read the agreement. | read |
resolve_agreement_review | Marks a review reviewed or dismissed, with a note. | write |
sync_agreement_reviews | Raises review requests for new events. | write |
Cap table#
| Tool | What it does | Access |
|---|---|---|
captable_overview | Shows totals, ownership by holder and classes. | read |
captable_quick_start | Creates Common Stock, an option plan and founder entries. | write |
captable_list_stakeholders | Lists people and entities with what they hold. | read |
captable_create_stakeholder | Adds one stakeholder. | write |
captable_create_stakeholders | Adds up to 50 stakeholders, all or nothing. | write |
captable_update_stakeholder | Changes a stakeholder's name, email, kind or notes. | write |
captable_delete_stakeholder | Deletes a stakeholder and everything they hold. | destructive |
captable_list_share_classes | Lists share classes with rights and issued counts. | read |
captable_create_share_class | Creates a share class. | write |
captable_update_share_class | Changes a share class's name or rights. | write |
captable_delete_share_class | Deletes a share class with nothing issued. | destructive |
captable_list_issuances | Lists shares, options, RSUs and warrants. | read |
captable_create_issuance | Records one issuance. | write |
captable_create_issuances | Records up to 50 issuances, all or nothing. | write |
captable_update_issuance | Corrects an issuance. | write |
captable_cancel_issuance | Cancels an issuance but keeps its history. | write |
captable_mark_exercised | Records that an option or warrant was exercised. | write |
captable_delete_issuance | Permanently deletes an issuance record. | destructive |
captable_list_option_plans | Lists option plans with pool size and availability. | read |
captable_create_option_plan | Creates an option plan. | write |
captable_update_option_plan | Changes a plan's name, size or approval date. | write |
captable_delete_option_plan | Deletes an option plan; its grants stay. | destructive |
captable_list_convertibles | Lists SAFEs and notes with terms and status. | read |
captable_create_convertible | Records an unconverted SAFE or note. | write |
captable_update_convertible | Corrects an outstanding SAFE or note. | write |
captable_cancel_convertible | Marks a SAFE or note cancelled but keeps it. | write |
captable_delete_convertible | Permanently deletes a SAFE or note record. | destructive |
captable_list_valuations | Lists 409A valuations with safe-harbor status. | read |
captable_add_valuation | Records a 409A valuation. | write |
captable_delete_valuation | Permanently deletes a 409A record. | destructive |
captable_get_settings | Returns currency, par value and authorized shares. | read |
captable_update_settings | Sets currency, par value, authorized shares, incorporation date. | write |
captable_import_founders_from_agreement | Creates founder shares from the agreement's equity split. | write |
captable_agreement_alignment | Compares founder shares with the agreement's equity split. | read |
Modeling#
| Tool | What it does | Access |
|---|---|---|
captable_vesting_schedule | Shows vested and unvested grants and upcoming vesting. | read |
captable_list_rounds | Lists closed financing rounds. | read |
captable_model_round | Models a priced round without saving anything. | read |
captable_compare_round_scenarios | Compares 2 to 5 round scenarios side by side. | read |
captable_close_round | Records a priced round for real, with conversions. | destructive |
captable_run_waterfall | Shows who gets what at a given exit value. | read |
captable_waterfall_curve | Returns payouts by group across exit values. | read |
captable_save_scenario | Saves a round or exit scenario for the web app. | write |
captable_list_scenarios | Lists saved scenarios. | read |
captable_delete_scenario | Deletes a saved scenario. | destructive |
captable_dilution_calculator | Applies rounds to an ownership percentage; needs no cap table. | read |
Modeling output is an estimate from the numbers in your cap table, not legal, tax or financial advice. captable_close_round changes your cap table for real, so ask your agent to show the model first.