submit_and_pay_job_from_file
Submit a job using a file from disk as input, bypassing inline data transfer for large or binary files. The file is sent directly peer-to-peer, with optional text instructions.
Instructions
Same as submit_and_pay_job, but the job input is read from a file on disk by the MCP server instead of being passed inline by the LLM. Use this when the input is large or binary (images, logs, captured output) and the LLM only needs to forward it - the file content never enters the model's output tokens. input_path may be absolute or relative to the MCP server's working directory. The file is ALWAYS transferred peer-to-peer via iroh, so this needs: a persistent agent, a PAID provider skill (free skills reject file inputs), and the iroh addon. Text files reach the skill on stdin; binary files via ELISYM_INPUT_FILE. Pass an optional prompt to send a text instruction alongside the file (e.g. how to edit an image); it rides inline (encrypted) while the file rides P2P.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | Optional text instruction sent alongside the file (e.g. how to edit an image: "make it night", "add a hat"). It rides inline (NIP-44 encrypted) in the job event while the file travels peer-to-peer via iroh. The single attachment slot holds the file, so the prompt cannot spill to a second transfer - keep it short. | |
| capability | No | general | |
| input_path | Yes | Path to a regular file whose contents become the job input. Absolute or relative to the MCP server's working directory. | |
| session_id | No | Conversation control. Omit for automatic session management (providers advertising context support get a conversation auto-started on first contact; an ongoing conversation triggers a continue/new/one-off question before anything is published). Pass "new" to force a fresh conversation, "none" to force a stateless one-off, or a session_id from a previous result to continue that conversation. The provider answers with the conversation context of prior exchanges under the same id. | |
| kind_offset | No | ||
| timeout_secs | No | ||
| provider_npub | Yes | ||
| allow_outside_cwd | No | Allow reading a file outside the MCP server working directory. Off by default - the file content is forwarded to the provider before payment and is invisible in the transcript, so reads are confined to the working dir unless this is set. Sensitive files (secret keys, .env, SSH/keypair, ~/.elisym, /proc) are always refused. | |
| max_price_lamports | No |