Rivian MCP

Instructions

Implementation Reference

• mcp-server.js:521-535 (registration)

  Tool registration with MCP server, including the schema definition (vehicle_id parameter) and handler that calls rivian.getDriversAndKeys() and formats the output.
  server.tool( 'rivian_get_drivers_and_keys', 'See who has access to your vehicle — drivers, phone keys, and key fobs.', { vehicle_id: z.string().describe('Vehicle ID from your account info'), }, async ({ vehicle_id }) => { try { requireAuth(); return text(formatDriversAndKeys(await rivian.getDriversAndKeys(vehicle_id))); } catch (err) { return text(err.message); } }, );
• mcp-server.js:527-534 (handler)

  The async handler function that executes when the tool is called - requires authentication, calls the API, and returns formatted text.
  async ({ vehicle_id }) => { try { requireAuth(); return text(formatDriversAndKeys(await rivian.getDriversAndKeys(vehicle_id))); } catch (err) { return text(err.message); } },
• mcp-server.js:525-525 (schema)

  Zod schema defining the vehicle_id input parameter for the tool.
  vehicle_id: z.string().describe('Vehicle ID from your account info'),
• lib/rivian.js:224-248 (handler)

  Core implementation that executes the GraphQL query to Rivian's API to fetch drivers, phone keys, and key fobs for a given vehicle.
  export async function getDriversAndKeys(vehicleId) { const body = { operationName: 'DriversAndKeys', query: `query DriversAndKeys($vehicleId: String) { getVehicle(id: $vehicleId) { __typename id vin invitedUsers { __typename ... on ProvisionedUser { firstName lastName email roles userId devices { type mappedIdentityId id hrid deviceName isPaired isEnabled } } ... on UnprovisionedUser { email inviteId status } } } }`, variables: { vehicleId }, }; return (await gql(GRAPHQL_GATEWAY, body, authHeaders())).getVehicle; }
• mcp-server.js:347-380 (helper)

  Helper function that formats the API response into readable text, displaying user roles, devices, and their pairing/enabled status.
  function formatDriversAndKeys(data) { const lines = []; if (data.vin) lines.push(`Vehicle: ${data.vin}`); if (!data.invitedUsers?.length) { lines.push('No drivers or keys found.'); return lines.join('\n'); } lines.push(''); for (const user of data.invitedUsers) { if (user.firstName) { lines.push(`${user.firstName} ${user.lastName} (${user.email})`); if (user.roles?.length) lines.push(` Roles: ${user.roles.join(', ')}`); if (user.devices?.length) { for (const d of user.devices) { const name = d.deviceName || d.type; const status = [ d.isPaired ? 'paired' : 'not paired', d.isEnabled ? 'enabled' : 'disabled', ].join(', '); lines.push(` ${name} — ${status}`); } } } else { lines.push(`${user.email} (invited, ${user.status})`); } lines.push(''); } return lines.join('\n').trim(); }