Submission reports
Structured Markdown report format, how to generate reports, and how to feed them to agents.
Submission reports are structured Markdown documents designed for agent re-processing. Each report contains aggregate stats, per-field distributions, and a granular submission table — all in a format that any LLM can parse and act on without custom tooling.
Generating a report
CLI:
mf report contact
mf report contact --since 2026-04-01 --until 2026-04-30MCP tool:
get_submission_report({ slug: "contact", period: "7d" })REST API:
curl https://app.form.gold/api/forms/contact/report?period=30d \
-H "Authorization: Bearer YOUR_API_KEY"Supported periods: 7d, 30d, 90d, all.
Report format
# Submission Report: Contact Us
**Form slug:** contact
**Period:** 2026-04-01 – 2026-04-30
**Generated:** 2026-04-28T12:00:00Z
---
## Summary
| Metric | Value |
|---|---|
| Total views | 310 |
| Total submissions | 42 |
| Completion rate | 13.5% |
| Submissions this period | 18 |
| Change vs prior period | +28.6% |
---
## Field distributions
### campaign_type (radio)
| Option | Count | % |
|---|---|---|
| CEX listing | 8 | 44% |
| OTC partnership | 5 | 28% |
| Influencer campaign | 3 | 17% |
| Media coverage | 2 | 11% |
### regions (checkbox)
| Option | Count | % |
|---|---|---|
| North America | 14 | 78% |
| Europe | 11 | 61% |
| Asia Pacific | 7 | 39% |
| Latin America | 3 | 17% |
| Middle East & Africa | 2 | 11% |
---
## Submissions
| ID | Submitted | name | email | campaign_type |
|---|---|---|---|---|
| 01JE... | 2026-04-28 09:14 | Jane Smith | jane@acme.com | CEX listing |
| 01JD... | 2026-04-27 18:30 | Alex Chen | alex@corp.io | OTC partnership |Report structure rules
- One report per form per period. Do not concatenate reports — each covers a single slug and time window.
- Field distributions are only shown for
radio,checkbox, andselectfields. Free-text fields (text,textarea,email) are not distributed — their values appear only in the submissions table. - The submissions table includes every field as a column. File upload fields show the storage URL.
- Null/empty values are represented as an empty cell, not as
null,N/A, or a dash. - Dates are UTC ISO 8601, displayed as
YYYY-MM-DD HH:MMin the table for readability.
Feeding reports to agents
The report is designed to be pasted directly into a conversation or read by an MCP tool. Example agent prompts:
Summarize and visualize:
Here is my form report:
[paste report]
Summarize the key findings in 3 bullet points. Then generate a bar chart
of the campaign_type distribution using Mermaid syntax.Extract action items:
[paste report]
Based on the submission trends, what should I follow up on this week?
Group by campaign type and flag any respondents who selected "CEX listing"
and haven't been contacted.Compare two periods:
[paste report for April]
[paste report for March]
Compare month over month. Which fields showed the most change?