# Dungeon Fighter Online — how to use (mcp.ai)

Connect your Dungeon Fighter Online account and use 25 tools for gaming straight from your AI agent. Connect with your own API key. Dungeon Fighter Online (DFO) is an arcade-style, side-scrolling action game with RPG elements, offering players a dynamic combat experience.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dungeon_fighter_online?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dungeon_fighter_online_character_base_info`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dungeon_fighter_online`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dungeon_fighter_online/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/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_LIS
  - body: { server_id: string, character_id: string }
- `POST https://api.mcp.ai/api/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 t
  - body: { limit?: integer, serverId: string, wordType?: string, characterName: string }
- `POST https://api.mcp.ai/api/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 value
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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
  - body: { next?: string, limit?: integer, serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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,
  - body: { server_id: string, character_id: string }
- `POST https://api.mcp.ai/api/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 na
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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 equippe
  - body: { server_id: string, character_id: string }
- `POST https://api.mcp.ai/api/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.
  - body: { server_id: string, character_id: string }
- `POST https://api.mcp.ai/api/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,
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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 it
  - body: { serverId: string, characterId: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/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.
  - body: { item_id: string }
- `POST https://api.mcp.ai/api/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/
  - body: { item_id: string }
- `POST https://api.mcp.ai/api/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 combinati
  - body: { job_id: string, job_grow_id: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/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.
  - body: { itemIds: string }
- `POST https://api.mcp.ai/api/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 fet
  - body: { jobId: string, skillIds: string }
- `POST https://api.mcp.ai/api/dungeon_fighter_online/get/server/list` — Tool to retrieve the list of available game servers. Use when needing to know which servers are available.
- `POST https://api.mcp.ai/api/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.
  - body: { job_id: string, skill_id: string }
- `POST https://api.mcp.ai/api/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.
  - body: { jobId?: string, limit?: integer, isBuff?: boolean, maxFame?: integer, minFame?: integer, serverId: string, jobGrowId?: string, isAllJobGrow?: boolean }
- `POST https://api.mcp.ai/api/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.dfon
  - body: { q?: string, limit?: integer, hashtag?: string, itemName?: string, wordType?: string }
- `POST https://api.mcp.ai/api/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 sea
  - body: { limit?: integer, wordType?: string, setItemName: string }

## Example prompts
- "What can I do in Dungeon Fighter Online?"
- "Show me a summary of my Dungeon Fighter Online account"

## More
- Page: https://mcp.ai/dungeon_fighter_online
- Agent spec (llms.txt): https://mcp.ai/dungeon_fighter_online/llms.txt
- Postman collection: https://mcp.ai/dungeon_fighter_online/postman.json