# Dungeon Fighter Online

Dungeon Fighter Online (DFO) is an arcade-style, side-scrolling action game with RPG elements, offering players a dynamic combat experience.

- **Category:** gaming
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 25
- **Triggers:** 0
- **Slug:** `DUNGEON_FIGHTER_ONLINE`
- **Version:** 20260227_00

## Tools

### Character Base Information

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_BASE_INFO`

Retrieves comprehensive base information for a Dungeon & Fighter Online character, including level, job details, fame, adventure/account info, and guild membership. Prerequisites: - Use GET_SERVER_LIST to obtain valid server IDs (e.g., "cain", "siroco") - Use CHARACTER_SEARCH to find character IDs by searching character names Returns character details including level, job/class information, fame points, adventure (account) name, and guild affiliation if applicable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `server_id` | string | Yes | Identifier of the server where the character exists. Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `character_id` | string | Yes | Unique identifier of the character. Use CHARACTER_SEARCH action to find valid character IDs by character name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Character Search

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_SEARCH`

Search for Dungeon Fighter Online characters by name on a specific server. Returns a list of characters matching the search criteria, including their ID, level, job information, and fame points. Use the Get Server List action first to obtain valid server IDs. Supports both exact matching and partial substring searches.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-100, default: 10) |
| `serverId` | string | Yes | Server identifier (use Get Server List action to retrieve valid server IDs) |
| `wordType` | string ("full" | "match") | No | Search mode: 'match' for exact name match only, 'full' for partial substring matching |
| `characterName` | string | Yes | Character name to search for (case-insensitive, supports partial matching) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Skill Buff Avatar

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_SKILL_BUFF_AVATAR`

Retrieves detailed information about a character's buff skill and equipped avatars that enhance it. Returns comprehensive data including: - Buff skill details (name, ID, level, description, stat values) - Avatar equipment in buff slots (jacket, pants, etc.) - Avatar properties (rarity, clone info, option abilities) - Emblems attached to each avatar piece Use this to analyze a character's buff skill configuration, avatar setup for skill enhancement, and emblem attachments. Requires valid serverId (from GET_SERVER_LIST) and characterId (from CHARACTER_SEARCH).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Server ID of the character (see /df/servers) |
| `characterId` | string | Yes | Character unique code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Skill Buff Status

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_SKILL_BUFF_STATUS`

Tool to fetch character's skill buff status information. Use when you need to know active buff statuses for a specific character.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Identifier of the server where the character exists. |
| `characterId` | string | Yes | Unique identifier of the character. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Character Status Info

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_STATUS_INFO`

Tool to retrieve status information of a specific character. Use after obtaining serverId and characterId to fetch current stats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Server ID for Dungeon Fighter Online |
| `characterId` | string | Yes | Character ID to retrieve status for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Character Timeline

**Slug:** `DUNGEON_FIGHTER_ONLINE_CHARACTER_TIMELINE`

Retrieves the activity timeline for a specific character in Dungeon Fighter Online. Returns a chronological list of timeline events (e.g., equipment changes, level ups, achievements) for the character. Use this tool after obtaining a valid serverId from server list and characterId from character search. Returns an empty timeline if no events are available for the character.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next` | string | No | Pagination cursor token for fetching the next page of results. Use the 'next' value from a previous response. |
| `limit` | integer | No | Maximum number of timeline records to retrieve per page. Defaults to API default if not specified. |
| `serverId` | string | Yes | ID of the server hosting the character. Use 'cain' or 'siroco' for DFO servers. |
| `characterId` | string | Yes | Unique 32-character hex identifier of the character obtained from character search |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Avatar Equipment

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_AVATAR`

Retrieves comprehensive information about a character's equipped avatar items in Dungeon Fighter Online. Returns character details and avatar equipment across all slots (hair, face, hat, neck, jacket, pants, belt, shoes, skin, weapon) including item details, rarities, clone avatars, option abilities, and attached emblems.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `server_id` | string | Yes | Server ID where the character exists. Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `character_id` | string | Yes | Unique character identifier. Use CHARACTER_SEARCH action to find character IDs by name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Buff Skill Creature

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_BUFF_CREATURE`

Retrieves detailed information about a character's buff skill creature equipment. Returns comprehensive data including: - Character information (name, level, job, guild) - Buff skill details (skill name, ID, level, description, stat values) - Creature equipped for the buff skill (item name, ID, rarity) Use this to analyze a character's buff skill creature configuration. Requires valid serverId (from GET_SERVER_LIST) and characterId (from CHARACTER_SEARCH). Note: Buff skill value information is provided based on the latest in-game login and can differ or be unavailable depending on character login circumstances.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Server ID where the character exists (e.g., 'cain', 'siroco'). Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `characterId` | string | Yes | Character unique identifier (32-character hexadecimal string). Use CHARACTER_SEARCH action to find valid character IDs by character name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Creature

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_CREATURE`

Tool to retrieve equipped creature information for a Dungeon & Fighter Online character. Use after obtaining serverId and characterId to fetch creature details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Server identifier where the character exists. Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `characterId` | string | Yes | Unique character identifier. Use CHARACTER_SEARCH action to find valid character IDs by character name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Equipment

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_EQUIPMENT`

Retrieves comprehensive equipment information for a Dungeon & Fighter Online character. Returns detailed data including: - Character base information (level, job, fame, adventure, guild) - All equipped items across 13 equipment slots - Item details (name, type, rarity, level requirements) - Enhancement information (reinforcement, amplification, refinement, enchantments) - Set item bonuses and fusion stone options - Upgrade, tuning, and exalted equipment details Prerequisites: - Use GET_SERVER_LIST to obtain valid server IDs - Use CHARACTER_SEARCH to find character IDs by name

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `server_id` | string | Yes | Server identifier where the character exists. Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `character_id` | string | Yes | Unique character identifier. Use CHARACTER_SEARCH action to find valid character IDs by character name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Equipped Insignia

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_INSIGNIA`

Retrieves character equipped insignia (flag) information from Dungeon Fighter Online. Returns character details and equipped insignia/flag items including reinforcement skills.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `server_id` | string | Yes | Server ID where the character exists. Use GET_SERVER_LIST action to retrieve valid server IDs. |
| `character_id` | string | Yes | Unique character identifier. Use CHARACTER_SEARCH action to find character IDs by name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Skill Buff Equipment

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_SKILL_BUFF`

Retrieves detailed information about a character's skill buff equipment, including the buff skill details and equipment items that enhance the buff. This action returns: - Character information (name, level, job, guild) - Buff skill information (skill name, level, description) - Equipment items that provide buff bonuses (weapon, armor, accessories, title) Prerequisites: - Valid server ID (use Get Server List action) - Valid character ID (use Character Search action) Note: Buff data is based on the character's latest in-game login.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Identifier of the server where the character exists (e.g., 'cain' or 'siroco'). Use the Get Server List action to obtain valid server IDs. |
| `characterId` | string | Yes | Unique identifier of the character (32-character hexadecimal string). Use the Character Search action to find valid character IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Character Skill Style

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_CHARACTER_SKILL_STYLE`

Tool to retrieve character skill style information. Use when you need to know a character's active skills, passive skills, skill evolutions, and skill enhancements. Note: Skill enhancements through items and equipment are excluded from this response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `serverId` | string | Yes | Identifier of the server where the character exists (e.g., 'cain' or 'siroco'). Use the Get Server List action to obtain valid server IDs. |
| `characterId` | string | Yes | Unique identifier of the character (32-character hexadecimal string). Use the Character Search action to find valid character IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item Hashtags

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_ITEM_HASHTAGS`

Tool to retrieve the list of all available item hashtags for searching items. Use when needing to know which hashtag categories are available for item searches.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item Information

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_ITEM_INFO`

Retrieves detailed information for a specific item in Dungeon & Fighter Online. Equipment stats are shown based on Superior 100% grade values. Titles are shown based on average Ordinary grade values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Unique identifier code for the item. Use SEARCH_ITEMS action to find valid item IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item Shop Info

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_ITEM_SHOP_INFO`

Tool to retrieve item shop sell information for specific equipment. Use when needing to find which NPCs sell a particular item and at what price. Only supports Lv.95 Epic and Lv.100+ Unique/Legendary/Epic equipment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Item unique code. Only Lv.95 Epic and Lv.100+ Unique/Legendary/Epic equipment sold in shops can be searched. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Jobs List

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_JOBS`

Tool to retrieve the list of all available character classes (jobs) in Dungeon Fighter Online. Use when needing to know which job classes are available in the game.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job Skills

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_JOB_SKILLS`

Tool to retrieve the complete list of skills available for a specific character class and advancement. Use when you need to know what skills are available for a particular job and job growth combination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Character class unique code. This identifies the base class of the character. |
| `job_grow_id` | string | Yes | Character Awakening class unique code. This identifies the advancement/specialization of the class. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Multiple Items

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_MULTIPLE_ITEMS`

Tool to retrieve detailed information for multiple items at once. Use when needing to fetch item details for up to 15 items in a single request. Duplicate item IDs will be processed only once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `itemIds` | string | Yes | Comma-separated list of item unique codes. Up to 15 items can be requested. Duplicate IDs will be processed only once. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Multiple Skills Information

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_MULTIPLE_SKILLS`

Retrieves information for multiple skills of a character class at once. Up to 10 skills can be queried per request, with duplicate skill IDs automatically removed. Use this action when you need to fetch details for several skills simultaneously rather than making individual requests. The response includes skill names, levels, descriptions, and option values for each requested skill. Note: If invalid skill IDs are provided, they may be omitted from the response rather than causing an error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `jobId` | string | Yes | Character class unique code. Identifies the job/class for which skills are being queried. |
| `skillIds` | string | Yes | Comma-separated list of skill unique codes. Up to 10 skills can be queried at once. Duplicate skill IDs will be automatically removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Server List

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_SERVER_LIST`

Tool to retrieve the list of available game servers. Use when needing to know which servers are available.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Skill Information

**Slug:** `DUNGEON_FIGHTER_ONLINE_GET_SKILL_INFO`

Tool to retrieve detailed information for a specific skill of a character class. Use when you need to know skill stats, level requirements, MP costs, cooldowns, or level-by-level progression details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Character class unique code. This identifier represents the character's class/job. |
| `skill_id` | string | Yes | Skill unique code. This identifier represents the specific skill to retrieve information for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Characters By Fame

**Slug:** `DUNGEON_FIGHTER_ONLINE_SEARCH_CHARACTERS_BY_FAME`

Tool to search characters by fame ranking. Only returns characters level 110 or above that have logged in within 90 days. Use when you need to find high-ranking characters based on fame points.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `jobId` | string | No | Character class unique code to filter by specific job |
| `limit` | integer | No | Number of results to return (1-100, default: 10) |
| `isBuff` | boolean | No | Filter by character role: true for Buffer only, false for DPS only, omit to search all |
| `maxFame` | integer | No | Fame bracket maximum. If not specified, defaults to highest fame in the game (40,000 or higher) |
| `minFame` | integer | No | Fame bracket minimum. If not specified, defaults to maxFame - 10000. Maximum search range is 10,000 fame points |
| `serverId` | string | Yes | Server identifier. Use 'all' to search all servers, or use Get Server List action to retrieve specific server IDs |
| `jobGrowId` | string | No | Character advancement unique code (requires jobId to be specified) |
| `isAllJobGrow` | boolean | No | Retrieve all related advancements when jobGrowId is specified |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Items

**Slug:** `DUNGEON_FIGHTER_ONLINE_SEARCH_ITEMS`

Search for Dungeon Fighter Online items by name or hashtag. Only returns items currently obtainable in-game. Supports filtering by level range and rarity. Item images available at https://img-api.dfoneople.com/df/items/{itemId}.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | No | Query string for additional filters. Supports minLevel, maxLevel, and rarity filters (e.g., 'minLevel:50 maxLevel:100 rarity:Epic') |
| `limit` | integer | No | Maximum number of results to return (1-30, default: 10) |
| `hashtag` | string | No | Hashtag to filter items (requires URL encoding). Supports comma-separated values for multiple hashtags. Either itemName or hashtag must be provided. |
| `itemName` | string | No | Item name to search for (requires URL encoding). Either itemName or hashtag must be provided. |
| `wordType` | string ("match" | "front" | "full") | No | Search type: 'match' for exact match, 'front' for prefix matching, 'full' for full-text search |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Set Items

**Slug:** `DUNGEON_FIGHTER_ONLINE_SEARCH_SET_ITEMS`

Search for Dungeon Fighter Online set items by name. Returns a list of set items matching the search criteria, including their unique identifiers. Supports exact match, prefix match, and full text search modes. Use URL encoding for non-ASCII characters (automatically handled).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-100, default: 10) |
| `wordType` | string ("match" | "front" | "full") | No | Search type: 'match' for exact match, 'front' for prefix match, 'full' for full text search |
| `setItemName` | string | Yes | Set item name to search for (URL encoding will be handled automatically) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |