Manifest

Plugin Manifest

Make sure the plugin manifest file is accessible at /.well-known/ai-plugin.json on your domain. The URL should be similar to:

https://your-service/.well-known/ai-plugin.json

OpenAPI Bitte Extension

We have created an extension for the OpenAPI specification that allows you to include additional metadata.

"x-mb": {
  "account-id": "bitte.near",
  "email": "[e-mail]",
  "assistant": {
    "name": "agent-name",
    "description": "Shorter summary about the agent and it's capabilities",
    "instructions": "Detailed, specific instructions to be passed to AI Agent on it's funcitonality and tool usage.",
    "tools": [{ type: "generate-transaction" }, { type: "submit-query" }],
    // optional fields (recommended)
    "image": "https://agent-image.example",
    "categories": ["tags","for","your","agent"],
    "chainIds": [1,8453],
    "version": "0.1.27"
  }
}

Account ID (account-id)

• Description: Specifies the account ID associated with the plugin. This is typically the account ID on the NEAR blockchain that identifies the owner or operator of the API.

• Example: bitte.near

Agent Configuration (assistant)

Provides the configuration for the agent that will guide the user in interacting with the API. This section includes details about its behavior, and the tools it can use.

name

Instructions provided to the agent define its role or behavior. This helps tailor the agent’s responses according to specific requirements.

Example: "Weather Agent"

description

A general summary of the agent's functionalities and tools / endpoints.

instructions

Instructions provided to the agent define its role or behavior. This helps tailor the agent’s responses according to specific requirements.

Example: "You are a helpful agent. When using the get-weather tool make sure to know or ask for the user's location."

tools

A list of tools that the agent can use. Each tool is defined by its type and possibly other configurations.

Tool Type The type of tool that the agent can use. This can vary based on the functionality required by the API.

Tool Type	Description
generate-transaction	Creates a transaction based on the user request
submit-query	Creates a GraphQL query based on Mintbase's Indexer, submits it and returns the result
generate-image	Creates an image, uploads it to Arweave and returns a transaction hash
create-drop	Creates an NFT drop
generate-evm-tx	Creates an evm transaction based on users request

image

Image URL for your agent (recommended: 256x256px or 512x512px square)

categories

Array of tags that categorize your agent.

Example: ["DeFi", "Meme", "Investing"]

chainIds

Array of evm chains your agent operates in. This makes it easier for other people to find your agent and adds context to the LLMs.

Example: [1, 100, 8453, 42161]

version

Track the version of your agent.

Example: "1.0.2"