Skip to main content
Glama

FreeDailyPro Book Publishing Tools

publishing_onix

Read-onlyIdempotent

Build ONIX 3.0 book metadata XML from title, contributors, ISBN-13, price, subjects and a description, and get a list of problems found. Error issues are returned as 422. Field codes and rules: https://api.freedailypro.com/docs

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "title": "<title>",
      "contributors": "<contributors>",
      "isbn": "<isbn>",
      "publisher": "<publisher>",
      "pubDate": "<pubDate>"
    },
    "name": "publishing_onix"
  }
}

Input Schema

NameRequiredDescriptionDefault
isbnYesISBN-13 (978 or 979, valid check digit), hyphens allowed. An ISBN-10 is rejected.
titleYesProduct title; control characters are rejected (422).
pricesNoPrices as [{amount, currency, type?}], up to 20, for example [{"amount":"14.99","currency":"USD"}].
pubDateYesYYYY-MM-DD, YYYY-MM or YYYY, a real date; otherwise an error issue (422).
audienceNoONIX audience code: 01 general, 02 children, 03 young adult, 04 school, 05 college, 06 professional. Default not stated.
languageNoISO 639-2/B code in lower case, for example eng, fre, ger, spa; default eng. Unknown codes are an error issue.
subjectsNoSubject codes as [{scheme: bisac|thema, code}], up to 20.
subtitleNoSubtitle, up to 1000 characters.
pageCountNoPages as digits written as text, 1 to 999999; print forms without it get a warning.
publisherYesPublisher name, for example Example Press.
territoryNoWORLD (default) or two-letter country codes separated by spaces, for example US CA GB.
descriptionNoMain description; a warning when missing.
productFormNoBC paperback (default), BB hardback, EA digital download (EPUB).
availabilityNoONIX availability code (list 65), two digits; default 20 available, 10 not yet, 23 on demand, 40 not available.
contributorsYesContributors, at least one: [{name, inverted?, role?}].
shortDescriptionNoUp to 350 characters.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed27 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • removedInput schema / additionalProperties
      Removed value: -false
    • changedInput schema / properties / audience / description
      Previous value: -"ONIX audience code: 01 general/trade, 02 children/juvenile, 03 young adult, 04 primary and secondary education, 05 college/higher education, 06 professional and scholarly. Default: not stated."New value: +"ONIX audience code: 01 general, 02 children, 03 young adult, 04 school, 05 college, 06 professional. Default not stated."
    • changedInput schema / properties / availability / description
      Previous value: -"ONIX product availability code from code list 65, two digits. Default 20 (available). Common: 10 not yet available, 20 available, 23 manufactured on demand, 40 not available. A code that is not in list 65 (for example 99) is an error issue (422)."New value: +"ONIX availability code (list 65), two digits; default 20 available, 10 not yet, 23 on demand, 40 not available."
    • changedInput schema / properties / contributors / description
      Previous value: -"At least one named contributor."New value: +"Contributors, at least one: [{name, inverted?, role?}]."
    • removedInput schema / properties / contributors / items / additionalProperties
      Removed value: -false
    • changedInput schema / properties / contributors / items / properties / inverted / description
      Previous value: -"Name inverted for sorting, written Last name, First name (a warning when there is no comma)."New value: +"Name as Last name, First name (a warning when there is no comma)."
    • changedInput schema / properties / contributors / items / properties / role / description
      Previous value: -"ONIX contributor role code (code list 17). Default A01 (author). Common: B01 editor, A12 illustrator, B06 translator."New value: +"ONIX role code (list 17), default A01 author; B01 editor, A12 illustrator, B06 translator."
    • changedInput schema / properties / description / description
      Previous value: -"The main description; a warning when missing."New value: +"Main description; a warning when missing."
    • changedInput schema / properties / isbn / description
      Previous value: -"The ISBN-13 (978 or 979, valid check digit), hyphens allowed. An ISBN-10 is rejected with the ISBN-13 to use."New value: +"ISBN-13 (978 or 979, valid check digit), hyphens allowed. An ISBN-10 is rejected."
    • changedInput schema / properties / language / description
      Previous value: -"Three-letter ISO 639-2/B language code in lower case, for example eng, fre, ger, spa. Default eng. Checked against the ISO 639-2/B list (special codes mis, mul, und, zxx included); an unknown code such as xxx or zzz is an error issue (422)."New value: +"ISO 639-2/B code in lower case, for example eng, fre, ger, spa; default eng. Unknown codes are an error issue."
    • changedInput schema / properties / pageCount / description
      Previous value: -"Number of pages as digits, 1 to 999999, written as text. Anything else is an error issue (422); print forms without it get a warning."New value: +"Pages as digits written as text, 1 to 999999; print forms without it get a warning."
    • addedInput schema / properties / prices / description
      Added value: +"Prices as [{amount, currency, type?}], up to 20, for example [{\"amount\":\"14.99\",\"currency\":\"USD\"}]."
    • removedInput schema / properties / prices / items / additionalProperties
      Removed value: -false
    • changedInput schema / properties / prices / items / properties / amount / description
      Previous value: -"Digits with a decimal point and at most 2 decimals, for example 14.99. 0 and any other format are reported as an error issue (422)."New value: +"Digits with at most 2 decimals, for example 14.99; 0 is an error issue."
    • changedInput schema / properties / prices / items / properties / currency / description
      Previous value: -"Three-letter ISO 4217 code in capitals, for example USD. Anything else is an error issue (422)."New value: +"ISO 4217 code in capitals, for example USD."
    • changedInput schema / properties / prices / items / properties / type / description
      Previous value: -"ONIX price type: 01 recommended retail price EXCLUDING tax, 02 INCLUDING tax. Default by currency: 01 for USD and CAD (their prices are quoted before sales tax), 02 for every other currency. A warning is returned when USD or CAD is sent with 02. Two prices with the same currency and type are rejected."New value: +"01 price excluding tax, 02 including tax. Default 01 for USD and CAD, else 02."
    • changedInput schema / properties / productForm / description
      Previous value: -"ONIX product form: BC paperback (default), BB hardback, EA digital download (written with form detail E101, EPUB)."New value: +"BC paperback (default), BB hardback, EA digital download (EPUB)."
    • changedInput schema / properties / pubDate / description
      Previous value: -"Publication date as YYYY-MM-DD, YYYY-MM or YYYY, and a real calendar date. Anything else is reported as an error issue (422)."New value: +"YYYY-MM-DD, YYYY-MM or YYYY, a real date; otherwise an error issue (422)."
    • addedInput schema / properties / publisher / description
      Added value: +"Publisher name, for example Example Press."
    • addedInput schema / properties / subjects / description
      Added value: +"Subject codes as [{scheme: bisac|thema, code}], up to 20."
    • removedInput schema / properties / subjects / items / additionalProperties
      Removed value: -false
    • changedInput schema / properties / subjects / items / properties / code / description
      Previous value: -"A BISAC code such as FIC027020 (three letters, six digits) or a Thema code such as FBA or 1KBB."New value: +"BISAC code such as FIC027020, or Thema code such as FBA."
    • addedInput schema / properties / subjects / items / properties / scheme / description
      Added value: +"bisac or thema."
    • addedInput schema / properties / subtitle / description
      Added value: +"Subtitle, up to 1000 characters."
    • changedInput schema / properties / territory / description
      Previous value: -"WORLD, or two-letter country codes separated by spaces, for example US CA GB. Default WORLD. Anything else is an error issue (422)."New value: +"WORLD (default) or two-letter country codes separated by spaces, for example US CA GB."
    • changedInput schema / properties / title / description
      Previous value: -"The product title. Control characters (for example U+0001) are rejected with 422, not removed."New value: +"Product title; control characters are rejected (422)."
  2. Changed3 schema fields changed
    • changedInput schema / properties / availability / description
      Previous value: -"ONIX product availability code (code list 65). Default 20 (available). 10 not yet available, 40 not available."New value: +"ONIX product availability code from code list 65, two digits. Default 20 (available). Common: 10 not yet available, 20 available, 23 manufactured on demand, 40 not available. A code that is not in list 65 (for example 99) is an error issue (422)."
    • changedInput schema / properties / language / description
      Previous value: -"Three-letter ISO 639-2/B language code in lower case, for example eng, fre, ger, spa. Default eng. Anything else is reported as an error issue (422)."New value: +"Three-letter ISO 639-2/B language code in lower case, for example eng, fre, ger, spa. Default eng. Checked against the ISO 639-2/B list (special codes mis, mul, und, zxx included); an unknown code such as xxx or zzz is an error issue (422)."
    • changedInput schema / properties / title / description
      Previous value: -"The product title."New value: +"The product title. Control characters (for example U+0001) are rejected with 422, not removed."
  3. Changed48 schema fields changed
    • addedInput schema / properties / audience / description
      Added value: +"ONIX audience code: 01 general/trade, 02 children/juvenile, 03 young adult, 04 primary and secondary education, 05 college/higher education, 06 professional and scholarly. Default: not stated."
    • addedInput schema / properties / audience / enum
      Added value: +[
      +  "01",
      +  "02",
      +  "03",
      +  "04",
      +  "05",
      +  "06"
      +]
    • addedInput schema / properties / availability / description
      Added value: +"ONIX product availability code (code list 65). Default 20 (available). 10 not yet available, 40 not available."
    • addedInput schema / properties / availability / pattern
      Added value: +"^[0-9]{2}$"
    • addedInput schema / properties / contributors / description
      Added value: +"At least one named contributor."
    • addedInput schema / properties / contributors / items / properties / inverted / description
      Added value: +"Name inverted for sorting, written Last name, First name (a warning when there is no comma)."
    • addedInput schema / properties / contributors / items / properties / inverted / maxLength
      Added value: +300
    • addedInput schema / properties / contributors / items / properties / name / description
      Added value: +"Name as printed, for example Jane Q. Writer."
    • addedInput schema / properties / contributors / items / properties / name / maxLength
      Added value: +300
    • addedInput schema / properties / contributors / items / properties / name / minLength
      Added value: +1
    • changedInput schema / properties / contributors / items / properties / role / description
      Previous value: -"ONIX role code, default A01 (author)"New value: +"ONIX contributor role code (code list 17). Default A01 (author). Common: B01 editor, A12 illustrator, B06 translator."
    • addedInput schema / properties / contributors / items / properties / role / pattern
      Added value: +"^[A-Z][0-9]{2}$"
    • addedInput schema / properties / contributors / maxItems
      Added value: +50
    • addedInput schema / properties / contributors / minItems
      Added value: +1
    • addedInput schema / properties / description / description
      Added value: +"The main description; a warning when missing."
    • addedInput schema / properties / description / maxLength
      Added value: +100000
    • addedInput schema / properties / isbn / description
      Added value: +"The ISBN-13 (978 or 979, valid check digit), hyphens allowed. An ISBN-10 is rejected with the ISBN-13 to use."
    • addedInput schema / properties / isbn / maxLength
      Added value: +40
    • addedInput schema / properties / isbn / minLength
      Added value: +1
    • addedInput schema / properties / language / description
      Added value: +"Three-letter ISO 639-2/B language code in lower case, for example eng, fre, ger, spa. Default eng. Anything else is reported as an error issue (422)."
    • addedInput schema / properties / language / maxLength
      Added value: +10
    • addedInput schema / properties / pageCount / description
      Added value: +"Number of pages as digits, 1 to 999999, written as text. Anything else is an error issue (422); print forms without it get a warning."
    • addedInput schema / properties / pageCount / maxLength
      Added value: +10
    • addedInput schema / properties / prices / items / properties / amount / description
      Added value: +"Digits with a decimal point and at most 2 decimals, for example 14.99. 0 and any other format are reported as an error issue (422)."
    • addedInput schema / properties / prices / items / properties / amount / maxLength
      Added value: +20
    • addedInput schema / properties / prices / items / properties / currency / description
      Added value: +"Three-letter ISO 4217 code in capitals, for example USD. Anything else is an error issue (422)."
    • addedInput schema / properties / prices / items / properties / currency / maxLength
      Added value: +10
    • addedInput schema / properties / prices / items / properties / type / description
      Added value: +"ONIX price type: 01 recommended retail price EXCLUDING tax, 02 INCLUDING tax. Default by currency: 01 for USD and CAD (their prices are quoted before sales tax), 02 for every other currency. A warning is returned when USD or CAD is sent with 02. Two prices with the same currency and type are rejected."
    • addedInput schema / properties / prices / items / properties / type / enum
      Added value: +[
      +  "01",
      +  "02"
      +]
    • addedInput schema / properties / prices / maxItems
      Added value: +20
    • changedInput schema / properties / productForm / description
      Previous value: -"ONIX form code, for example BC paperback, BB hardback"New value: +"ONIX product form: BC paperback (default), BB hardback, EA digital download (written with form detail E101, EPUB)."
    • addedInput schema / properties / productForm / enum
      Added value: +[
      +  "BB",
      +  "BC",
      +  "EA"
      +]
    • changedInput schema / properties / pubDate / description
      Previous value: -"YYYYMMDD, YYYY-MM-DD or YYYY-MM"New value: +"Publication date as YYYY-MM-DD, YYYY-MM or YYYY, and a real calendar date. Anything else is reported as an error issue (422)."
    • addedInput schema / properties / pubDate / maxLength
      Added value: +20
    • addedInput schema / properties / publisher / maxLength
      Added value: +300
    • addedInput schema / properties / publisher / minLength
      Added value: +1
    • addedInput schema / properties / shortDescription / description
      Added value: +"Up to 350 characters."
    • addedInput schema / properties / shortDescription / maxLength
      Added value: +350
    • addedInput schema / properties / subjects / items / properties / code / description
      Added value: +"A BISAC code such as FIC027020 (three letters, six digits) or a Thema code such as FBA or 1KBB."
    • addedInput schema / properties / subjects / items / properties / code / maxLength
      Added value: +40
    • addedInput schema / properties / subjects / items / properties / code / minLength
      Added value: +1
    • addedInput schema / properties / subjects / maxItems
      Added value: +20
    • addedInput schema / properties / subtitle / maxLength
      Added value: +1000
    • addedInput schema / properties / territory / description
      Added value: +"WORLD, or two-letter country codes separated by spaces, for example US CA GB. Default WORLD. Anything else is an error issue (422)."
    • addedInput schema / properties / territory / maxLength
      Added value: +200
    • addedInput schema / properties / title / description
      Added value: +"The product title."
    • addedInput schema / properties / title / maxLength
      Added value: +1000
    • addedInput schema / properties / title / minLength
      Added value: +1
  4. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (read-only, idempotent, closed-world), so the description earns credit for adding validation semantics: problems are reported and error-level issues come back as 422. It still leaves the success response shape vague, since no output schema exists and it never says whether XML text, warnings, or a summary is returned.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One compact sentence states the action, the inputs, and the validation outcome, followed by a short second sentence on error handling and a docs pointer. It is front-loaded with no filler, though the docs URL is doing work the prose could have done.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter generation tool with no output schema, the description should clarify what the successful response looks like and how warnings versus errors differ. It covers the 422 error path but leaves the success payload and the warning/error distinction under-specified.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so every field, enum, default, and constraint is already documented in the input schema. The description only enumerates the field categories (title, contributors, ISBN-13, price, subjects, description) without adding meaning beyond that. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: build ONIX 3.0 book metadata XML from a named set of fields, plus a validation report. That is clearly distinguishable from a bare ISBN or description helper. It does not name a sibling or say how it differs from publishing_isbn, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: you supply book metadata and receive XML plus problems, with a docs link for field codes. There is no statement of when to prefer this over publishing_isbn or publishing_kdp_description, and no prerequisites or exclusions are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources