droid-mcp-nfc/io.droidmcp.nfc/ReadNfcTagTool

ReadNfcTagTool

class ReadNfcTagTool(context: Context) : McpTool

Reads NDEF data from the most recently scanned NFC tag.

Does not actively scan: it returns the tag cached in NfcTagCache, which the host Activity populates from onNewIntent() via NFC foreground dispatch. Requires NFC to be available and enabled. Read-only.

For NDEF tags it first tries a live read; if the tag has left the field (TagLostException) it serves the NDEF snapshot NfcTagCache took at discovery time and reports cached = true.

Output keys: has_tag; when a tag is cached, tag_id (hex), is_ndef, and tech_list (non-NDEF tags) or is_ndef/max_size/is_writable/records (each record: tnf, type, payload) plus cached (true when served from the discovery-time snapshot, false for a live read). When no tag is cached: has_tag false plus a message.

Constructors

ReadNfcTagTool

constructor(context: Context)

Properties

annotations

open override val annotations: ToolAnnotations

description

open override val description: String

name

open override val name: String

outputSchema

open override val outputSchema: Map<String, Any>

parameters

open override val parameters: List<ToolParameter>

Functions

execute

open suspend override fun execute(params: Map<String, Any>): ToolResult