[Integrations](https://spiral.ai/integrations) › [Factory Droid](https://spiral.ai/integrations/factory-droid) › [Inkling](https://spiral.ai/integrations/factory-droid/inkling)

# How to Use Inkling in Factory Droid

Inkling suits coding, tool-driven tasks, and answers grounded in supplied documents. Its adjustable thinking effort lets you balance reasoning depth against token use.

|  |  |
| --- | --- |
| Model | Inkling |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.021612 per run at the default inputs. $1.30 per 1M input tokens, $5.265 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Inkling in Factory Droid

- Use Inkling to inspect this project's failing tests, identify the cause, and make the smallest justified fix. Add a regression check and report what you ran.
- Use Inkling to build a searchable release-notes page using this project's existing components. Include keyboard navigation, an empty state, and tests for the search behavior.
- Use Inkling with more thinking effort to trace how authentication state moves through this repository. Cite file locations, identify inconsistent behavior, and propose a focused repair.
- Use Inkling to compare the API implementation with the specification in this project. List discrepancies with file references, then fix the discrepancies covered by existing requirements.
- Use Inkling to review this diff for behavior changes and missing error handling. Explain each finding with a concrete failure scenario and suggest a test that would catch it.

## How to set up Inkling in Factory Droid

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Droid saves it to your user config, `~/.factory/mcp.json`, so it works in every project.

```bash
droid mcp add spiral https://api.spiral.ai/mcp --type http
```

2. **Sign in**: Start `droid`, type `/mcp`, select spiral and authenticate it. Sign in to Spiral in the browser and click Authorize. No API key.

3. **Check it**: Spiral shows as connected. needs authentication means the sign-in did not finish: run `/mcp` again.

```bash
droid mcp list
```

### Use the Spiral skill

1. **Send Factory Droid this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Inkling**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openrouter",
    "model": "thinkingmachines/inkling",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: Factory Droid finds Inkling on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/factory-droid

## Inkling tools and prices

- [Thinking Machines: Inkling](https://spiral.ai/tools/openrouter/thinkingmachines/inkling) (OpenRouter): Up to $0.021612 per run at the default inputs. $1.30 per 1M input tokens, $5.265 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| stop |  | — |  |
| min_p | 0 to 1 | — |  |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |

## What can you do with Inkling in Factory Droid?

Turn a bug report or feature specification into code with Inkling's coding and reasoning capabilities. Give the agent project context and measurable acceptance criteria so it can check the result.

### Fix a reproducible software bug

Give Inkling the failing behavior, relevant code, and expected result. Ask for a focused patch and a regression check that reproduces the original failure.

### Build a small web application

Ask Inkling to implement a concrete workflow with explicit requirements, such as a form with validation and a results view. Define what must work before requesting visual refinements.

### Answer questions from a knowledge base

Supply relevant passages and ask Inkling to cite passage identifiers in its answer. Require an explicit statement when the supplied material does not answer the question.

### Compare conflicting documents

Have Inkling compare policy drafts or product specifications, identify contradictions, and link each finding to the supporting passage. Keep proposed resolutions separate from documented requirements.

### Draft multilingual support replies

Give Inkling the customer's message, approved support guidance, and desired response language. Ask it to preserve product names and flag missing policy details.

### Investigate a technical incident

Provide a timeline and relevant log excerpts. Ask Inkling to rank possible causes, cite evidence, and suggest a check that could disprove each explanation.

### Prepare a recurring change digest

Use Inkling to compare newly retrieved release notes with the previous report. Request a short digest of changed behavior, supporting links, and unresolved questions.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All Factory Droid guides](https://spiral.ai/integrations/factory-droid)

## Inkling in other agents

- [Amp](https://spiral.ai/integrations/amp/inkling)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/inkling)
- [Claude](https://spiral.ai/integrations/claude-desktop/inkling)
- [Claude Code](https://spiral.ai/integrations/claude-code/inkling)
- [Cline](https://spiral.ai/integrations/cline/inkling)
- [Codex](https://spiral.ai/integrations/codex/inkling)
- [Cursor](https://spiral.ai/integrations/cursor/inkling)
- [Devin](https://spiral.ai/integrations/devin/inkling)
- [dots](https://spiral.ai/integrations/dots/inkling)
- [Gemini](https://spiral.ai/integrations/gemini/inkling)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/inkling)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/inkling)
- [goose](https://spiral.ai/integrations/goose/inkling)
- [Grok](https://spiral.ai/integrations/grok/inkling)
- [Grok Build](https://spiral.ai/integrations/grok-build/inkling)
- [Hermes](https://spiral.ai/integrations/hermes/inkling)
- [Instinct](https://spiral.ai/integrations/instinct/inkling)
- [Manus](https://spiral.ai/integrations/manus/inkling)
- [Muse](https://spiral.ai/integrations/muse/inkling)
- [Muse Code](https://spiral.ai/integrations/muse-code/inkling)
- [n8n](https://spiral.ai/integrations/n8n/inkling)
- [Notion](https://spiral.ai/integrations/notion/inkling)
- [OpenClaw](https://spiral.ai/integrations/openclaw/inkling)
- [opencode](https://spiral.ai/integrations/opencode/inkling)
- [Perplexity](https://spiral.ai/integrations/perplexity/inkling)
- [Raycast](https://spiral.ai/integrations/raycast/inkling)
- [VS Code](https://spiral.ai/integrations/vscode/inkling)
- [Windsurf](https://spiral.ai/integrations/windsurf/inkling)
- [Zapier](https://spiral.ai/integrations/zapier/inkling)

## More Factory Droid guides

- [Hy4 Preview](https://spiral.ai/integrations/factory-droid/hy4-preview)
- [Inkling 2 Mini](https://spiral.ai/integrations/factory-droid/inkling-2-mini)
- [Hy4 Flash](https://spiral.ai/integrations/factory-droid/hy4-flash)
- [Inkling 2 Small](https://spiral.ai/integrations/factory-droid/inkling-2-small)
- [Hy4](https://spiral.ai/integrations/factory-droid/hy4)
- [Inkling Small](https://spiral.ai/integrations/factory-droid/inkling-small)

## Questions about Inkling in Factory Droid

**Can Factory Droid use Inkling?**

Yes. Add Spiral to Factory Droid as an MCP server, and Factory Droid can find and run Inkling like any built-in tool.

**How much does Inkling cost in Factory Droid?**

Up to $0.021612 per run at the default inputs. $1.30 per 1M input tokens, $5.265 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Factory Droid plan is separate.

**Do I need an OpenRouter account to use Inkling in Factory Droid?**

No. Spiral runs Inkling on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Inkling in Factory Droid?**

About two minutes: add the server, then sign in, then check it.

**Does Factory Droid wait while Inkling runs?**

Inkling runs in the background. Factory Droid starts the run, checks on it and gives you the text, json when it's ready.

**What is Inkling good for?**

Inkling is designed for coding, reasoning, tool use, and answering questions from retrieved information. Practical tasks include fixing software bugs, comparing documents, and drafting answers grounded in a knowledge base.

**How much context can Inkling handle?**

Thinking Machines documents up to one million tokens of model context. Treat that as the model's documented capacity, rather than a guarantee that every request can use the full window.

**When should I increase Inkling's thinking effort?**

Try more thinking effort for difficult debugging, competing explanations, or problems with several constraints. Compare the results on representative tasks: the control balances performance against token use.

**What are Inkling's weaknesses?**

Inkling can produce plausible but unsupported statements, and its maker does not claim it is the strongest overall model. For factual tasks, supply evidence and ask it to distinguish supported conclusions from assumptions.

**Can Inkling work in languages other than English?**

Yes. Thinking Machines describes general multilingual capabilities; test your target language and terminology with examples before using it for repeated work.

