> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Dungeon Fighter Online

The Dungeon Fighter Online connector lets your AI agent act in each user's Dungeon Fighter Online account. Each user connects their own Dungeon Fighter Online API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** API Key
**Categories:** Media
**Tools:** 25: 25 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=DUNGEONFIGHTERONLINE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Dungeon Fighter Online connection

   In **AgentKit > Connections**, create a Dungeon Fighter Online connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'dungeonfighteronline'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Dungeon Fighter Online:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'dungeonfighteronline_classes_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "dungeonfighteronline"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Dungeon Fighter Online:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="dungeonfighteronline_classes_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Dungeon Fighter Online credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'dungeonfighteronline_character_avatar_get',
  toolInput: {
    character_id: '<character_id>',
    server_id: '<server_id>',
  },
  connector: 'dungeonfighteronline',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="dungeonfighteronline_character_avatar_get",
    tool_input={
        "character_id": "<character_id>",
        "server_id": "<server_id>",
    },
    connection_name="dungeonfighteronline",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `dungeonfighteronline_character_avatar_get`

Get Character Avatar · Read-only

Get the equipped avatar (costume) of one Dungeon Fighter Online character.
Returns each avatar slot's item, emblems and clone avatar.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_buff_avatar_get`

Get Character Buff Avatar · Read-only

Get the buff-enhancement avatar of one Dungeon Fighter Online character.
Returns the buff skill and the avatar registered to enhance it.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_buff_creature_get`

Get Character Buff Creature · Read-only

Get the buff-enhancement creature of one Dungeon Fighter Online character.
Returns the buff skill and the creature registered to enhance it.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_buff_equipment_get`

Get Character Buff Equipment · Read-only

Get the buff-enhancement equipment of one Dungeon Fighter Online character.
Returns the buff skill and the equipment registered to enhance it.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_creature_get`

Get Character Creature · Read-only

Get the equipped creature (pet) of one Dungeon Fighter Online character.
Returns the creature item and its artifacts.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_equipment_get`

Get Character Equipment · Read-only

Get the equipped equipment of one Dungeon Fighter Online character.
Returns each slot's item with reinforcement, refinement, enchantments, upgrades and active set items.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_get`

Get Character · Read-only

Get the basic profile of one Dungeon Fighter Online character.
Returns name, level, class, advancement, adventure club, guild and fame.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_mist_assimilation_get`

Get Character Mist Assimilation · Read-only

Get the mist assimilation of one Dungeon Fighter Online character.
Returns the character's mist assimilation information.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_oath_get`

Get Character Oath · Read-only

Get the equipped oath of one Dungeon Fighter Online character.
Returns the oath info, crystals, set info and blessing.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_skill_style_get`

Get Character Skill Style · Read-only

Get the skill build of one Dungeon Fighter Online character.
Returns active, passive, evolution and enhancement skills with levels, plus skill chains (item-based skill boosts excluded).
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_character_status_get`

Get Character Status · Read-only

Get the stats of one Dungeon Fighter Online character.
Returns the character's stats such as HP, MP, attack, defense, elemental values and buff power.
Use Search Characters to get the server and character IDs. Data covers characters that logged in within the last year and reflects their latest login.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_id` (`string`, required): Character unique code, from Search Characters. Example: c6aa9f1b0c4e2f3d8a7b6c5d4e3f2a1b.
- `server_id` (`string`, required): DFO server ID of the character, from List Servers. Example: cain.

Example input: `{"character_id":"<character_id>","server_id":"<server_id>"}`

### `dungeonfighteronline_characters_fame_search`

Search Characters By Fame · Read-only

Rank Dungeon Fighter Online characters by adventurer fame on a server, filtered by fame range, class and buffer or DPS role.
Returns characters with their fame, level, class and advancement, highest fame first.
Only level 110+ characters active in the last 90 days are included; the range is capped at 10,000 fame.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `server_id` (`string`, required): DFO server ID, such as cain or siroco, from List Servers. Character search and fame ranking also accept all. Example: all.
- `is_all_job_grow` (`boolean`, optional): When jobGrowId is set, true also returns every related advancement of that line. Example: false.
- `is_buff` (`boolean`, optional): true for buffers only, false for DPS only; omit for both. Example: true.
- `job_grow_id` (`string`, optional): Class advancement (awakening) unique code, from List Classes. Requires jobId. Example: 37495b941da3b1661bc900e68ae8b4f1.
- `job_id` (`string`, optional): Character class unique code, from List Classes. Example: 41f1cdc2ff58bb5fdc287be0db2a8df3.
- `limit` (`integer`, optional): Maximum number of characters to return, up to 200. Default 10. Example: 50.
- `max_fame` (`integer`, optional): Highest fame to include. Default the highest fame in the game. Example: 50000.
- `min_fame` (`integer`, optional): Lowest fame to include. Default maxFame minus 10000. Example: 40000.

Example input: `{"server_id":"<server_id>"}`

### `dungeonfighteronline_characters_search`

Search Characters · Read-only

Search Dungeon Fighter Online characters by name on one server or all servers, optionally by class.
Returns matching characters with serverId, characterId, name, level, class, advancement and fame.
Use this to get a character ID for the other character tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `character_name` (`string`, required): Character name to search for. Example: Seria.
- `server_id` (`string`, required): DFO server ID, such as cain or siroco, from List Servers. Character search and fame ranking also accept all. Example: all.
- `is_all_job_grow` (`boolean`, optional): When jobGrowId is set, true also returns every related advancement of that line. Example: false.
- `job_grow_id` (`string`, optional): Class advancement (awakening) unique code, from List Classes. Requires jobId. Example: 37495b941da3b1661bc900e68ae8b4f1.
- `job_id` (`string`, optional): Character class unique code, from List Classes. Example: 41f1cdc2ff58bb5fdc287be0db2a8df3.
- `limit` (`integer`, optional): Maximum number of characters to return, up to 50. Default 10. Example: 10.
- `word_type` (`string`, optional): How the name is matched: match (exact) or full (contains). Default match. Example: match. One of: `match`, `full`.

Example input: `{"character_name":"<character_name>","server_id":"<server_id>"}`

### `dungeonfighteronline_class_skills_list`

List Class Skills · Read-only

List the skills of a Dungeon Fighter Online class advancement.
Returns each skill's skillId, name, type and required level.
Use Get Skill for one skill's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_grow_id` (`string`, required): Advancement (awakening) code of the class, from List Classes. Example: 37495b941da3b1661bc900e68ae8b4f1.
- `job_id` (`string`, required): Character class unique code, from List Classes. Example: 41f1cdc2ff58bb5fdc287be0db2a8df3.

Example input: `{"job_grow_id":"<job_grow_id>","job_id":"<job_id>"}`

### `dungeonfighteronline_classes_list`

List Classes · Read-only

List the Dungeon Fighter Online classes and their advancements (awakenings).
Returns each jobId and jobName with its jobGrowId and jobGrowName entries.
Use these IDs in character search, fame ranking and skill tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `dungeonfighteronline_item_get`

Get Item · Read-only

Get the full details of one Dungeon Fighter Online item.
Returns its name, rarity, type, level, stats (at Superior 100% grade), options, set membership and description.
The item image is at https://img-api.dfoneople.com/df/items/<itemId>.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): Item unique code, from Search Items or a character's equipment. Example: 93a1d27e36e3071154abfc063977a844.

Example input: `{"item_id":"<item_id>"}`

### `dungeonfighteronline_item_hashtags_list`

List Item Hashtags · Read-only

List the hashtags used to classify Dungeon Fighter Online items.
Returns the hashtag names.
Use them in Search Items.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `dungeonfighteronline_item_shop_get`

Get Item Shop Info · Read-only

Get where an equipment item is sold in in-game shops.
Returns the shops selling it and their prices.
Covers level 95 Epic and level 100+ Unique, Legendary and Epic equipment listed in the DFOpedia.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): Item unique code, from Search Items or a character's equipment. Example: 93a1d27e36e3071154abfc063977a844.

Example input: `{"item_id":"<item_id>"}`

### `dungeonfighteronline_items_get_multiple`

Get Multiple Items · Read-only

Get the details of up to 15 Dungeon Fighter Online items in one call.
Returns the same details as Get Item for each item.
Duplicate IDs are returned once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `item_ids` (`string`, required): Item IDs to look up, comma-separated, up to 15. Example: 93a1d27e36e3071154abfc063977a844,3efb6b1f6079c569c67b5dc7f13a2085.

Example input: `{"item_ids":"<item_ids>"}`

### `dungeonfighteronline_items_search`

Search Items · Read-only

Search Dungeon Fighter Online items by name or hashtag, optionally by level range and rarity.
Returns matching items with itemId, name, rarity, type and available level.
Give item_name or hashtag. Use Get Item for one item's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `hashtag` (`string`, optional): Item hashtags to search for, comma-separated (see List Item Hashtags). Give this or item_name. Example: Fire,Strength.
- `item_name` (`string`, optional): Item name to search for. Give this or hashtag. Example: Clear Cube Fragment.
- `limit` (`integer`, optional): Maximum number of items to return, up to 30. Default 10. Example: 30.
- `q` (`string`, optional): Extra filters as comma-separated key:value pairs: minLevel and maxLevel (equip level) and rarity (Common, Uncommon, Rare, Unique, Epic, Chronicle, Legendary or Mythic). Example: minLevel:100,maxLevel:115,rarity:Epic.
- `word_type` (`string`, optional): How the name is matched: match (exact), front (starts with, items only) or full (contains). Default match. Example: match. One of: `match`, `front`, `full`.

Example input: `{}`

### `dungeonfighteronline_servers_list`

List Servers · Read-only

List the Dungeon Fighter Online (global) game servers.
Returns each server's serverId and serverName.
Use a serverId in the character tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `dungeonfighteronline_set_item_get`

Get Set Item · Read-only

Get one Dungeon Fighter Online item set.
Returns the set's pieces and the bonuses it gives at each piece count.
Use Search Set Items to find the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `set_item_id` (`string`, required): Set item unique code, from Search Set Items. Example: 0e8c1f3a6b2d4c5e7f9a1b3c5d7e9f02.

Example input: `{"set_item_id":"<set_item_id>"}`

### `dungeonfighteronline_set_items_search`

Search Set Items · Read-only

Search Dungeon Fighter Online set items by name.
Returns matching sets with setItemId and setItemName.
Use Get Set Item for the set's pieces and bonuses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `set_item_name` (`string`, required): Set item name to search for. Example: Cleansing Light.
- `limit` (`integer`, optional): Maximum number of sets to return, up to 100. Default 10. Example: 10.
- `word_type` (`string`, optional): How the name is matched: match (exact), front (starts with, items only) or full (contains). Default match. Example: match. One of: `match`, `front`, `full`.

Example input: `{"set_item_name":"<set_item_name>"}`

### `dungeonfighteronline_skill_get`

Get Skill · Read-only

Get one Dungeon Fighter Online skill's details for a class.
Returns the skill's description, type, level requirements and values per level.
Use List Class Skills to find the skill ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Character class unique code, from List Classes. Example: 41f1cdc2ff58bb5fdc287be0db2a8df3.
- `skill_id` (`string`, required): Skill unique code, from List Class Skills. Example: 5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d.

Example input: `{"job_id":"<job_id>","skill_id":"<skill_id>"}`

### `dungeonfighteronline_skills_get_multiple`

Get Multiple Skills · Read-only

Get the details of up to 10 skills of one Dungeon Fighter Online class in one call.
Returns the same details as Get Skill for each skill.
Duplicate IDs are returned once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Character class unique code, from List Classes. Example: 41f1cdc2ff58bb5fdc287be0db2a8df3.
- `skill_ids` (`string`, required): Skill IDs to look up, comma-separated, up to 10. Example: 5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d,6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e.

Example input: `{"job_id":"<job_id>","skill_ids":"<skill_ids>"}`

## Related

Other Media connectors ([all 65](/agentkit/connectors/?category=media)):

- [Spotify](/agentkit/connectors/spotify/): Scalekit connector, OAuth, 47 tools
- [Reddit](/agentkit/connectors/reddit/): Scalekit connector, OAuth, 105 tools
- [Diarize](/agentkit/connectors/diarize/): Scalekit connector, Access token, 3 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
