How to submit

January 1, 0001

To submit your project, register your GitHub repository, give the grader read access, and configure a webhook so GitHub can notify it when you push changes. Complete all three steps below.

1. Register your repository

Open Submit your project and fill in the form:

FieldWhat to enter
AssignmentThe exercise you are submitting.
Repository URLYour repository’s URL, for example https://github.com/username/repository. Use your own assignment repository.
Student IDYour matricola.
EmailYour university email address ending in @studenti.uniroma1.it.

Click Submit. After a successful registration, the page displays a deploy key, a webhook URL, and a webhook secret.

Save the returned values before leaving or refreshing the page. The deploy key and webhook secret are shown only once. Keep the secret somewhere safe: you will also need it to retrieve your run artifacts.

Keep the submission page open while you complete the GitHub setup in another tab.

2. Give the grader read access

The deploy key lets the grader read your repository to build and test your solution.

  1. On GitHub, open the repository you registered.
  2. Go to Settings → Deploy keys → Add deploy key.
  3. Enter a descriptive title, such as MCP Grader.
  4. Paste the complete deploy key from the submission page into Key.
  5. Leave Allow write access unchecked. Read access is enough.
  6. Click Add key.

Add the key to this repository’s deploy keys, rather than to your personal account’s SSH keys. See GitHub’s deploy key instructions for more details.

3. Configure the webhook

The webhook lets GitHub notify the grader when you push code to your repository.

  1. In the same repository, go to Settings → Webhooks → Add webhook.
  2. Fill in the settings below using the values returned by the submission page.
  3. Click Add webhook.
SettingValue
Payload URLhttps://grader-api.francescodb.me/webhook/github
Content typeapplication/json
SecretCopy the webhook secret from the submission page exactly.
SSL verificationLeave SSL verification enabled.
EventsSelect Just the push event.
ActiveLeave this checked.

Use the generated secret, rather than choosing a new one: the grader needs the matching value to verify notifications from GitHub. See GitHub’s webhook instructions for help finding these settings.

4. Push your solution and check the results

Once both GitHub settings are in place, commit and push your solution to the branch required by the exercise. For later updates to the same repository and assignment, push your changes using the same setup.

Results may take time to appear. Check the exercise’s leaderboard and compare the displayed commit hash with the commit you pushed. For details about update timing and viewing run output, see the FAQ.

If something goes wrong

  • Registration fails: read the error shown above the Submit button, check the selected assignment and repository URL, and make sure you used your university email address.
  • You cannot find the repository settings: check that you opened your own assignment repository and have permission to manage its deploy keys and webhooks.
  • The grader cannot read your repository: check that the complete deploy key was added to the same repository URL you registered.
  • Push notifications fail: check the webhook URL, JSON content type, and secret. In GitHub’s webhook settings, inspect Recent deliveries for failed requests.
  • Your result still shows an older commit: check that you pushed to the expected branch and allow time for grading. Consult the FAQ before submitting the form again.
  • You lost the generated key or secret: contact the course staff through the channels in the FAQ for help recovering access.

Submit your project