1
Tool Reference
Latte edited this page 2026-06-29 13:46:52 +00:00

Tool Reference

Every MCP tool familiar exposes, grouped by module (~80 in total). All tools follow the conventions in Architecture:

  • Read tools take an optional character (name or id). Omit it to run across all logged-in characters; pass one to scope to that character. Public tools (market, universe, zKill) need no login at all.
  • Write tools (marked WRITE) take a required character and a confirm flag. With confirm=false (the default) they return a dry-run preview and change nothing. See Write Safety.
  • Corp tools resolve each character's corporation and require the relevant corp role, or ESI returns 403 for that character.

Health

Tool Description
ping Health check — confirms the server is alive and reports name, version, UTC time.
write_status Whether familiar is currently allowed to perform write actions.
sde_status Whether the local SDE is available, and the path it's expected at.
account_status Which characters familiar is logged in as (no network call).

Market — public, no auth

Tool Description
list_hubs List the known NPC trade hubs and their region/system/station IDs.
get_market_price Best buy/sell price and spread for an item at a trade hub.
get_market_orders Order book: best limit sell or buy orders for an item at a hub.
compare_hubs Compare an item's best sell/buy price across every known trade hub.

Universe — public, no auth

Tool Description
resolve_names Resolve EVE names (items, systems, regions, stations) to their IDs.
get_item Look up an item/type by name or id (volume, group, description).
get_system Look up a solar system: security status, region, counts.
get_station Look up a station: which system, type, and services.
get_region Look up a region by name or id.
get_route Number of jumps and the system path between two systems.

Account — authenticated read

Tool Description
get_wallet Wallet balance (ISK) for one character or all.
get_skills Total SP, unallocated SP, and skill count.
get_skill_queue Upcoming skill-queue entries.
get_location Current system/station, active ship, online status.
get_clones Home station, jump clones, active implants.
get_assets Asset summary (total stacks + a sample).

Industry — character + corp read

Tool Description
get_industry_jobs Active/queued industry jobs.
get_blueprints Owned blueprints (ME/TE, runs).
get_mining_ledger Personal mining ledger (recent mined ore by day).
get_corp_industry_jobs Corp industry jobs (Factory Manager role).
get_corp_blueprints Corp blueprints (corp role).

Trade — character + corp read

Tool Description
get_contracts Personal contracts.
get_my_orders Open market orders you placed (not a hub book).
get_corp_contracts Corp contracts (corp role).
get_corp_orders Corp market orders (Accountant/Trader role).

Structures — authenticated read

Tool Description
search_structures Search structures by name (needs structure access).
get_structure Info for one structure (name, system, type, owner).
get_structure_market Market orders inside a player structure.
get_container_logs Corp container audit logs (corp role).

Killmails — read + zKill

Tool Description
get_killmails Recent killmails (most recent enriched with detail).
get_corp_killmails Recent corp killmails (corp role).
get_zkill_stats PvP stats from zKillboard (public, no auth).

Profile / social — authenticated read

Tool Description
get_loyalty_points Loyalty points per NPC corporation.
get_standings Standings toward NPC entities.
get_medals Awarded medals.
get_titles Corp titles held.
get_agents_research Active R&D agent research.
get_notifications Recent notifications.
get_chat_channels Owned/operated chat channels.
get_jump_fatigue Jump fatigue / clone-jump timers.

Corp organization — corp-role read

Tool Description
get_corp_members Corp member character ids (corp role).
get_corp_member_tracking Member tracking: last login, location, ship (Director).
get_corp_divisions Hangar/wallet division names (Director).
get_corp_titles Corp titles and their granted roles (corp role).
get_corp_medals Corp medals (corp role).
get_corp_standings Corp standings toward other entities (corp role).
get_my_corp_roles The character's own corp roles (no special role needed).

Corp economy & facilities — corp-role read

Tool Description
get_corp_wallets Balances of the corp's wallet divisions (Accountant/Junior Accountant).
get_corp_assets Corp assets (Director).
get_corp_mining Corp mining observers (moon drills etc.) (Accountant).
get_corp_facilities Corp industry facilities (Factory Manager).
get_corp_starbases Corp starbases / POSes (Director).

Misc — FW, projects, freelance, activities, access

Tool Description
get_fw_stats Faction-warfare stats.
get_corp_fw_stats Corp faction-warfare stats (corp role).
get_freelance_jobs Freelance jobs available/accepted.
get_corp_freelance_jobs Freelance jobs posted by the corp (corp role).
get_corp_projects Corp projects (corp role).
get_activities Character activity tracking.
get_access_lists Access control lists (ACLs).

Planetary interaction — read

Tool Description
get_planets Planetary colonies (planet, type, upgrade level).
get_planet_layout Full layout (pins, links, routes) of one colony.
get_corp_customs_offices Corp customs offices / POCOs (corp role).

Comms — mail & calendar (read + write)

Tool Description
get_mail Recent mail headers.
read_mail Full body of a single mail.
get_calendar Upcoming calendar events.
send_mail (WRITE) Send an EVE mail from a character.
set_mail_read (WRITE) Mark a mail read/unread.
respond_calendar_event (WRITE) Respond to a calendar event (accepted/declined/tentative).

Contacts (read + write)

Tool Description
get_contacts Personal contacts.
get_corp_contacts Corp contacts (corp role).
get_alliance_contacts Alliance contacts (resolved via each character's corp's alliance).
add_contacts (WRITE) Add personal contacts with a standing.
remove_contacts (WRITE) Remove personal contacts.

Fittings (read + write)

Tool Description
get_fittings Saved ship fittings.
create_fitting (WRITE) Save a new fitting.
delete_fitting (WRITE) Delete a saved fitting.

Fleet (read + write)

Tool Description
get_fleet Current fleet (settings + member count).
invite_to_fleet (WRITE) Invite a character to a fleet.
update_fleet (WRITE) Update fleet MOTD / free-move setting.

UI commands (write only)

Tool Description
set_waypoint (WRITE) Set/append an autopilot waypoint in the client.
open_window (WRITE) Open an in-game window (market, information, contract).