Skip to main content
Glama
ArsNovaSingers

ars-nova-wordpress-mcp

Official

Call an Ars Nova plugin REST route

ans_rest_call
Destructive

Invoke any REST route in Ars Nova's own namespaces to access plugin capabilities that lack a dedicated tool, so new endpoints work immediately without rebuilding the connector.

Instructions

Call any route in one of the Ars Nova plugins' own REST namespaces. Use this for capabilities that have no dedicated tool yet — it means a new plugin endpoint is usable the moment it is deployed, with no connector rebuild.

RESTRICTED BY DESIGN to namespaces we author: ars-nova/v1, ans-ops/v1, ans-notes/v1, ansg/v1. It cannot call wp/v2, wc/v3 or third-party plugin routes — those have their own purpose-built tools with validation this does not provide.

Environment safety: this goes through the same client as every other tool, so it hits whichever site this connector is configured for. Call wp_check_environment first if you are unsure whether you are on DEV or LIVE.

Useful ars-nova/v1 routes (ars-nova-ticketing-bridge v1.4.0):

  • GET tickera/introspect — what is ACTUALLY registered: shortcodes, post types, taxonomies, ticket-product meta keys. Use this instead of assuming.

  • GET tickera/status

  • GET tickera/events | tickera/event/{id}

  • POST tickera/event/{id} — update title/date/location/status

  • DEL tickera/event/{id} — trash (?force=1 to delete)

  • GET tickera/ticket-types | tickera/ticket-type/{id}

  • POST tickera/ticket-type/{id} — update price/status/template/stock/virtual

  • POST tickera/assign-template — { template_id, event_id?, product_ids? }

  • GET tickera/event-categories — the season's "projects"

  • POST tickera/event-categories — { name, slug?, description?, ans_page_id? }

  • POST tickera/event-category/{id} — rename, re-describe, re-link, reassign events

  • GET tickera/attendees — issued tickets

Args:

  • namespace (enum): one of the allowed namespaces. Required.

  • route (string): path within it, no leading slash. Required.

  • method (enum): GET | POST | PUT | PATCH | DELETE. Default GET.

  • query (object): query-string parameters.

  • body (object): JSON body for writes.

  • response_format (enum): markdown | json.

Returns: the endpoint's JSON response verbatim.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyNoJSON body for POST/PUT/PATCH, e.g. { title: 'Cross Currents — May 21' }.
queryNoQuery-string parameters as an object, e.g. { event_id: 6633, per_page: 20 }.
routeYesRoute within the namespace, no leading slash. e.g. 'tickera/introspect' or 'tickera/event/6665'.
methodNoHTTP method. Default GET. Use POST to update an existing resource.GET
namespaceYesWhich of our own REST namespaces to call. Restricted by design.
response_formatNoOutput format: 'markdown' for human-readable, 'json' for machine-readable.markdown
Behavior5/5

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

Beyond the annotations (destructiveHint=true), the description adds essential context: it is 'RESTRICTED BY DESIGN' to owned namespaces, it hits the configured site (environment safety), and it gives concrete examples of destructive actions like 'DEL tickera/event/{id} — trash (?force=1 to delete)'. Returns are specified as JSON verbatim.

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?

The description is front-loaded with a clear purpose and structured into sections (purpose, restrictions, safety, route catalog, Args, Returns). While it is long, the route catalog is highly useful for a generic tool, but the 'Args:' section partially duplicates the schema, making it slightly less concise than ideal.

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

Completeness5/5

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

For a generic REST-calling tool with no output schema and many possible endpoints, the description covers the essentials: what it can call, what it cannot, environment safety, parameter usage, and return format ('Returns: the endpoint's JSON response verbatim'). It also mentions calling wp_check_environment for safety, making it complete for the intended use case.

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

Parameters4/5

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

Schema coverage is 100% with detailed per-parameter descriptions and examples, so the baseline is 3. The description adds value by listing concrete routes (e.g., 'tickera/introspect') and their purposes, which clarifies how to construct route, query, and body even though the schema already provides analogous examples.

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

Purpose5/5

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

The description clearly states the tool's function: 'Call any route in one of the Ars Nova plugins' own REST namespaces.' It uses a specific verb (call), the resource (routes in owned namespaces), and explicitly differentiates from sibling tools by noting it's for capabilities with no dedicated tool yet.

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

Usage Guidelines5/5

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

The description provides explicit when-to-use guidance ('Use this for capabilities that have no dedicated tool yet'), explicit exclusions ('It cannot call wp/v2, wc/v3 or third-party plugin routes — those have their own purpose-built tools'), and a direct prerequisite ('Call wp_check_environment first if you are unsure whether you are on DEV or LIVE').

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ArsNovaSingers/ars-nova-wordpress-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server